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COURSr S£SC;^I?TIOK 
F80A Multics Virtual Memory Analysis and Metering 



Duration: Five Days 

Intended For: Personnel requiring analysis-level knowledge c: 

Multics virtual memory implementation, metering and 
tuning. Especially useful for personnel concerned 
with maximizing system performance.. 

Synoosis: The Multics supervisor is logically divided into seven 

distinct sub'systems. This course details _ the 
functions performed (and the data bases maintained) by 
five of these subsystems: Volume Management, Name and 
Address Space Management, Directory Control, Segment 
Con-trol, and Page Control. Knowledge of _ the virtual 
memory imoiementation gives the student insight into 
the metering and tuning of the system. Other topics 
include overviews of the Multics system hardware, the 
Multics Supervisor, and a comparison with other memory 
management" techniques. Question End_ answer periods 
are given daily to reinforce the material presented. 

Objectives: Upon completion o: this course, the student should be 

able to: 

subsystems, especially those subsystems vhicr. 
implement the Multics virtual memory. 

2. Make optim.al design choices when writing system 
applications to run in the Multics environment. 

3. Evaluate and tune the system's performance by 
analyzing the system's virtual memory meters. 

■Prerequisites: Multics Subsystem Programming (F15D) , Source Level 

Debugging & The Process Environment (F21) or 
equivalent experience. 

Major Topics: System Hardware Components 

Volume (Disk) Management 
Name Space/Address Space Management 
Directory, Segment and Page Control 
Memory Management Techniques 
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TOPIC I 
Multics Design Philosophy 
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MAJOR DESIGN GOALS 



B MULTIPLEXED INFORMATION AND COMPUTING SERVICE (MULTICS: 



8^ MULTICS WAS ONE OFJTHE FIRST OPERATING SYSTEMS- -TO BE THOROUGHLY 
DESIGNED FRO MjrHS^ TdP DOWfj THE DEVELOPERS: 



STARTED WITH A SET OF GOALS 



CREATED A SYSTEM WHICH WOULD SATISFY THESE GOALS 



DEVELOPED GENERAL SOLUTIONS INSTEAD OF SPECIFIC SOLUTIONS 
(MAKING THE PRODUCT EXTENDABLE) ; - ^ 



PRODUCED A VIABLE AND MARKETABLE PRODUCT 
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MAJOR DESIGN GOALS 



a THESE GOALS wERS CAREFULLY CHOSEN TO CHARACTERIZE A 'UTILITY-GRADE' 
COMPUTER SYSTEM, AND ARE OUTLINED BELOW: 



I VIRTUAL MEMORY ORGANIZATION 

D SELECTIVE, CONTROLLED SHARING 

[ SECu'RITY 

I OPEN-ENDED, MODULAR SYSTEM 

I DECENTRALIZED ADMINISTRATION 



^- FLEXIBLE USER INTERFACES, END-USER ORIENTATION 



5 CONTINUOUS OPERATION 



RELIABLE FILE SYSTEM 



REMOTE ACCESS 



EFFICIENT SERVICE TO LARGE AND SMALL USER 
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VIRTUAL MEMORY ORGANIZATION 



B MOTIVATION 



n TNF0RK.21TI0N STORED ON-LINE IN LARGE INFORMATION UTILITIES OFTEN 
" EXCEEDS THE SIZE OF AVAILABLE MAIN MEMORY -_ -■_ 



~\ THIS INFORMATION SHOULD BE DIRECTLY (AND CONTINUOUSLY) 
ACCESSIBLE BY THE USER COMMUNITY 



THE SIZE OF MAIN MEMORY SHOULD ONLY AFFECT PROCESSING TIME, NOT 
PROCESSING CAPABILITY 



MAIN MEMORY MANAGEMENT SHOULD BE A TASK FOR THE ^OPERATING 
SYSTEM, NOT THE PROGRAMMER - ,. - . - 



8 IMPLEMENTATION 



ALL ON-LINE INFORMATION IS PROCESSOR ADDRESSABLE 



ALL INFORMATION (PROCEDURE AND DATA) IS COMPARTMENTALIZED INTO 
UNItS called "SEGMENTS" ALLOWING THE ASSOCIATION OF ATTRIBUTES 



WITH EACH SEGMENT(l) 



(1 



ROUGHOUT THIS DOCUMENT, GENERIC REFERENCES TO "SEGMENTS" INCLUDE 
RECTORIES AS '.7ELL , SINCE DIRECTORIES ARE SIMPLY A SPSC-A^ r...ND 



D 

OF SEGMEN 



"CO* 
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VIHTUAl ;-SMORY ORGANIZATION 

SEGMENTS ARE MADE PROCESS ADDRESSABLE AS THEY ARE REFERENCED 

1 ALL SEGMENTS ARE DIVIDED INTO AN INTEGRAL NUMBER OF ^1024 WORD 
PAGES. THESE PAGES ARE BROUGHT INTO MAIN MEMORY IF ANI5 ONLY IF 

- THEY ARE REFERENCED (NEEDED) -AT THE TIMS THEY ARE REFSRShKSD -BY- 
ANY PROCESS " . : . 



THE MULTICS HARDWARE INTERPRETS ALL ADDRESSES AS OFFSETS WITHIN 
A SPECIFIED SEGMENT (SEGNO I OFFSET) 



THE HARDWARE MAKES NO DISTINCTION BETWEEN PROCEDURE AND DATA 
SEGMENTS. BOTH ARE PAGED IN THE SAMS MANNER, BOTH ARE ADDRESSED 
IN THE SAME MANNER 



ALL COMPILERS PRODUCE LOAD MODULES - NO MODIFICATION IS REQUIRED 
TO EXECUTE PROCEDURE CODE 
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SELECTIVE, CONTROLLED SHARING 



B MOTIVATION 



USERS SHOULD BE ABLE TO USE COMMON PROCEDL*RE AND DATA SEGMENTS 
DIRECTLY (NOT COPIES) 



E "" USERS= SHOULD BE ABLE TO SHARE PRIVATE CODE IN A SELECTIVE _M.ANNER 



s IMPLEMENTATION 



PURE, REENTRANT CODE IS ALWAYS GENERATED BY- THE - COMPILERS 
(ALLOWING SHARING OF PROCEDURE CODE IN A MULTI -PROCESS 
SNVI RONMENT ) 



£ViKY'iHING THE USER TOUCHES (E2ECUTS OR REFERENCE) WILL BE A 
SEGMENT HAVING ITS OWN ATTRIBUTES 



THE ACCESS ATTRIBUTES OF EACH SEGMENT ARE ESTABLISHED BY THE 
OWNER OF THAT SEGMENT 
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SECURITY 



B MOTIVATION 



I IK AN EN^/IRONMENT OF SEVERAL COESI STING PROCESSES, USERS MUST B: 
PROTECTED FROM ACCIDENTALLY OR INTENTIONALLY INTERFERING WITJ 



EACH OTHER 



THE SUPERVISOR MUST BE PROTECTED FROM DAMAGE 3Y USERS 



CHANGES IN ACCSSS TO INFORMATION MUST BE IMMEDIATELY EFFSCTI\^ 



DISCLOSURE OF INFORMATION SHOULD BE ALLOWED IN A SELECTIVE AND 
CONTROLLED MANNER (VERSUS ALL-OR-NONE APPROACH) - ._.. 



UIWARRANTSD DENIAL OF ACCESS TO INFORMATION MUST BE PROHIBITED 



E IMPLEMENTATION 



I PER-SSGMENT ACCESS CONTROL LIST (ACL) - SPECIFYING BY WHOM AND 
HOW THE SEGMENT MAY BE ACCESSED 



RING PROTECTION MECHANISM - ISOLATES SEGMENTS AND PROCESSES 



ACCESS ISOLATION MECHANISM (AIM) - ISOLATES SEGMENTS ACCOPIJING 
TO CATEGORIES AND SECURITY LEVELS 



PASSWOP.DS AND AL^DIT TRAILS 
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SECURITY 




ACL 



km 



RING !■ 






Jones.ProjA.a 
Top Secret/NATO 
Ring 4 



1 

f SEGMENT j. 



(Yes) 



(No) 



(Yes) 



rw •.ProjA. • 
Secret/Air Force 
Ring Brackets 1,7,7 
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OPEN-ENDED, MODULAR SYSTEM 



B MOTIVATION 



SOFTWARE SHOULD BE EAST TO MODIFY AND EXTEND 



-f THE OPERATING SYSTEM SHOULD BE MODULAR, AND THE MODULES SHOULD 
BE COMPREHENSIBLE 



E I MPLEMENTATI ON 



MODULAR DESIGN OF OPERA.TING SYSTEM AND USER PROGRAMS (COMPILERS., 
PROGRAMMING ENVIRONMENT ENCOURAGE MODULAR DESIGN")- 



[ UNIFORM PROGRAMMING CONVENTIONS ARE FOLLOWED THROUGHOUT MOST 



MORE THAN S2% OF THE OPERATING SYSTEM OBJECT CODE ORIGINATED 
'FROM PL/I SOURCE 



li DYNAMIC LINKING (ELIMINATES RE-COMPILING, RE-EDITING WHEN 
UN -BOUND MODULES ARE REPLACED) 



n ON-LINE MODIFICATION, TESTING AND INSTALLATION OF SYSTEM MODULES 
(hfJLTICS INSTALLATION FACILITY - MIS) 



PATCH-FP^S SYSTEM 

1 LIBRARY MANAGEMENT TOOLS AND LIBRARY CONVENTIONS 

Nor To Be Reproduced 1-S FSOA 



DECENTRALI ZED ADMI NI STRATI ON 



B MOTIVATION 



SYSTEM RESOURCES MUST BE EFFECTIVELY ADMINISTERED 



RESOURCE ALLOCATION, ACCOUNTING, REGISTRATION, BILLING, ETC/ IS 
TOO MUCH FOR SINGLE INDIVIDUAL . . 



DIFFERENT GROUPS OF USERS HAVE DIFFERENT ADMINI STR^.TIVE NEEDS 



B IMPLEMENTATION 



GROUPING OF USERS, BY FUNCTION OR MANAGEMENT, INTO PROJECTS 



I THREE-LEVEL HIERARCHY OF ADMINISTRATION 

D SYSTEM ADMINISTRATOR: DISTRIBUTES RESOURCES AND ASSIGNS 
ATTRIBUTES TO PROJECTS 

I PROJECT ADMINISTRATORS: DISTRIBUTES RESOURCES AND ASSIGNS 
ATTRIBUTES TO USERS 

USERS: HAS FULL CONTROL OVER ALLOCATED RESOURCES, MODIFIED 
BY ASSIGNED ATTRIBUTES 



AND ATTRIBUTES THAT HAVE BEEN GIVEN TO THE PROJECT 
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DECSNTRALI ZED ADMI NI STRATI ON 



PROCESS ATTRIBUTES 




ATTRIBUTES 
ASSIGNED 
TO 
PROJECT ABC 



ATTRIBUTES 
ASSIGNED 

PROJECT DEF 



^.. ,. - 





INTERSECTION 
OF ATTRIBUTES 
{COMPUTED AT 
LOGIN TIME) 
GIVEN TO May's 
rnwucoo 



ADDITIONAL DATA 
ABOUT May's 
PROCESS 



ATTRIBUTES 
ASSIGNED 
TO 
USER May 



ATTRIBUTES 

ASSIGNED 

TO 

USER Jones 



SYSTEM ADMINISTRATION TABLE 
(>tc1 >sat) 

CHEATED AND MAINTAINED 
BY SYSTEM ADMINISTRATOR 



PROCESS INITIALIZATION TABLE 
{[pdl>pit) 

ANSWERING SERVICE 
TABLE ENTRY 

(ANSWER_TABLE, 

ABSENTEE_USER_TABLE, 

DAEMON_USER_TABLE) 

CREATED AT LOGIN 
DESTROYED AT LOGOUT 



PROJECT DEFINITION TABLE 
(>SCl>pct>ABC.pdt) 

CREATED AND MAINTAINED 
BY PROJECT ADMINISTRATOR 
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FLEXIBLE USSR INTERFACES 



B MOTIVATION 



THE ■-- STANDARD USER ENVIRONMENT SHOULD 3E EXTENSIVELY 
USER-MODIFIABLE 



THE "CAPABILITY SKOL'LD EXIST TO DEVELOP AND IMPOSE CLOSED 
SUBSYSTEMS WHICH CAN PROVIDE ANY DESIRED ENVIRONMENT 



IMPLEMENTATION 



USER HAS ABILITY TO CHANGE OR REPLACE CONTROL PROGRAMS IN THE 
USER'S RING 



PROJECT ADMINISTRATOR CAN IMPOSE A CLOSED SUBSYSTEM ENVIRCNMEN' 
OR A DIFFERENT orocess overseer ON USERS 



start_uD.ec, A33REV PROCESSOR, aeneral_ready , ready_off, 
add search rules, CONDITION HANDLING, ETC. 



OTHER TOOLS PROVIDE SIMULATION, ENCAPSULATION C A? A3 1 LIT; 
(enter_lss, project^start__up_) 



STANDAPJD INTERFACE FOR INTERACTIVE SUBSYSTEMS {ssu_) ENCOURAGES 
UNIFORM, FAMILIAR BEHAVIOUR OF USER SUBSYSTEMS. 
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CON'TI NUOUS OPERATI ON 



E MOTIVATION 



UTILI-TY CONCEPT: SYSTEM SHOULD BE AVAILABLE ON DEMiAND AT AI 

TIMES 



B I MPLEMENTATI ON 



S ON-LINE SOFTWARE INSTALLATION 



ON-LINE MAINTENANCE: MOVE MORE AND MORE BOS CAPABILITY INTO 
MULTICS (EG: RE-BOOT FN? FROM MULTICS) 



I ON-LINE FILE BACKUP AND PJICOVERY 

J! ON-LINE ACCOUNTING AND BILLING 

t DYNAMIC RECONFIGURATION 

li DYNAMIC FAILSOFT DECONFIGURATION OF FAILING HAPJ3WARE 

I UNATTENDED SERVICE 

1 AUTOMATIC REBOOT 
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RELIABLE FILE SYSTEM 



B MOTIVATION 



MUST PROVIDE USERS SOME ASSURANCE THAT THEIR ON-LINE INFORMATION 
IS SAFE 



"must PROVIDE CHECKPOINT CAPABILITY FOR RECOVERY FROM USER ERROR 
OR SYSTEM DISASTER 



8 IMPLEMENTATION 



AUTOMATIC BACKUP/RETRIEVAL FACILITY - - 

CONSOLIDATED STORAGE SYSTEM DUMPS 

PHYSICAL AND LOGICAL SAVE/RESTORE 

ALL STORAGE SYSTEM RECOVERY PROCEDURES RUN WHILE SYSTEM IS UP 

DAMAGE RECOVERY RUN AUTOMATICALLY FOLLOWING SYSTEM FAILURE 
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REMOTE ACCESS 



B MOTIVATION 



UTILITY CONCEPT: FULL ACCESS FROM ANY PKONE IN THE WORLD VIA 
ANY REMOTE DEVI CE - . - . 



IJ-- WISH TO PROVIDE ONE "COMMAND LANGUAGE", TO SERVE ALL USERS, 
WHETHER LOCAL OR REMOTE, INTERACTIVE OR BATCH 



B IMPLEMENTATION 

MULTICS COMMUNICATION SYSTEM (MCS) ■ - ■ 

fj IN PRINCIPLE , ANY REMOTE DEVICE /TERMINAL IS CONNECT A3LE 



SINGLE COMMAND LANGUAGE 



REMOTE JOB ENTRY (RJE) AND BULK I/O CAPABILITIES 



E DIRECT ATTACHMENTS TO PUBLIC DATA NETWORKS VIA X.25 
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EFFICIENT SERVICE TO LARGE OR SMALL USERS 



B MOTIVATION 



UTILITY CONCEPT: SYSTEM SHOULD BE AVAILABLE FOR, AND CAPA5L- 
OF, ANY SIZE TASK 



RUNNING BOTH LARGE AND SMALL TASKS TOGETHER SHOULD NOT IMPAC! 
THE EFFICIENCY OF EITHER - -- 



B IMPLE.MENTATION 



|- DYNAMIC RESOURCE ALLOCATION (DON'T HAVE TO; PRE- ALLOCATE OR 
GUSSS-TIMATE RESOURCES REQUIRED) - . 






I DYNAMIC SYSTEM TUNING TO ACCOMMODATE CHANGING SYSTEM WORKLOADS 
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(End Of Topic) 



STRUCTURE OF THE OPERATING SYSTEM 



II SUBROUTINES (550) 

DESCRIBED IN THE MPM MANUALS "Multics Subroutines" (AG93) AND 
"Subsystems Writer's Guide" (OFTEN ABBREVIATED AS "SWG") 
(AK92) 



i TOOLS (220) 



DESCRIBED IN THE MPM MANUAL "Multics Commands and Active 
Functions" (AG92) 



ADMINISTRATIVE ROUTINES (200) 

I DESCRIBED IN THE MAM MANUALS "System Administrator" (AK50), 
"Registration & Accounting Administrator" CAS68), "Project 
Administrator" (AK51) 



B OPERATOR COMMANDS (150) 

i DESCRIBED IN THE MANUAL "Operator's Handbook" (AM81) 
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WHAT IS THE MULTICS SUPERVISOR 



B WHAT IS THE MULTICS SUPERVISOR? 



A COLLECTION OF MANY LOGICAL SUBSYSTEMS WHICH IMPLEMENT THE 
FUNCTIONS OF MULTICS 



THE PRIMARY PURPOSE OF MULTICS IS TO RUN PROGRAMS, WHICH ACCESS 
DATA, AND THUS THE MAJOR PURPOSE OF THE MULTICS SUPERVISOR IS TO 
MAKE THAT DATA ACCESSIBLE 



I THESE SUBSYSTEMS FALL INTO FOUR MAJOR GROUPS: 
D THE FILE SYSTEM 

D SUPPORT SERVICES FOR THE FILE SYSTEM 
MISCELLANEOUS SUPERVISOR SERVICES 



SUBSYSTEMS RELATED TO, BUT NOT STRICTLY PART OF THE 

CTTDTT.DVT QOB 



THESE DIVISIONS ARE SOMEWHAT ARTIFICIAL, BECAUSE THE SUBSYSTEMS 
ARE ALL INTIMATELY RELATED TO EACH OTHER. THE DIVISIONS 
REPRESENT A PARTICULAR VIEWPOINT OF SYSTEM FUNCTION. 



A MULTICS SUBSYSTEM IS A SET OF PROGRAMS PERFORMING A SPECIFIC 
SERVICE FOR THE USER COMMUNITY - AND FOR THE OPERATING SYSTEM 

ITSELF 



TOGETHER, ALL THESE SUBSYSTEMS IMPLEMENT THE FUNCTIONS DESCRIBED 
IN THE MPM SUBROUTINES AND SWG MANUALS, (ESSENTIALLY hcs_ AND 
THE VI RTUALS MEMORY ) . 
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THE MAJOR SUPERVISOR SUBSYSTEMS 



jB MAJOR MULTICS SUPERVISOR SUBSYSTEMS: FOUR GROUPS OF ABOUT -FOUR 

SUBSYSTEMS EACH 



THE FILE SYSTEM - THOSE SUBSYSTEMS WHICH ARE CONCERNED WITH 
STORING DATA, MANAGING DATA, AND MAKING IT AVAILABLE TO USERS. 
FIVE MAJOR COMPONENTS: 



I NAME SPACE / ADDRESS SPACE CONTROL 

DIRECTORY CONTROL 
B VOLUME MANAGEMENT 
D . SEGMENT CONTROL 

1 PAGE CONTROL 



SERVICES TO SUPPORT THE FILE SYSTEM, WHICH MULTIPLEX ITS 
FACILITIES BETWEEN DIFFERENT USERS, AND ENSURE ITS RELIABILITY. 
FOUR MAJOR COMPONENTS: 



[ TRAFFIC CONTROL 

i FAULT AND INTERRUPT HANDLING 

I SYSTEM INITIALIZATION 

I THE FILE SYSTEM SALVAGERS 
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THE MAJOR SUPERVISOR SUBSYSTEMS 



MISCELLANEOUS SUPERVISOR SERVICES - THESE ARE THINGS DONS IN THE 
SUPERVISOR FOR REASONS OF ACCESS CONTROL AND SHARING, BUT NOT 
DIRECTLY RELATED TO THE FILE SYSTEM 



BECAUSE THEY ARE NOT DIRECTLY RELATED, THEY WILL NOT BE COVERED 
IN ANY DETAIL 



I MULTICS COMMUNICATIONS SYSTEM 

j RESOURCE CONTROL 

USER DEVICE I/O -= ioi_ 

LOW LEVEL SUPERVISOR I/O 

RECONFIGURATION 

B SYSTEM ERROR HANDLING (syserr / verify__locic) 

RELATED SUBSYSTEMS - THESE ARE NOT ACTUALLY PART OF THE 
SUPERVISOR, BUT ARE CLOSELY RELATED 

METERING AND TUNING 

g THE Initializer .SysDaemon 



THE MULTICS SUPERVISOR IS DESIGNED AROUND THE ._ "LAYERED MACHINE" 
CONCEPT 
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THE MAJOR SUPERVISOR SUBSYSTEMS 



CONSTRUCT A SIMPLE SET OF OPERATIONS CALLED A "KERNEL" WHICH 
IMPLEMENTS THE MOST FUNDAMENTAL (PRIMITIVE) OPERATIONS REQUIRED 



CONSTRUCT A SLIGHTLY MORE SOPHISTICATED SET OF OPERATIONS WHICH 
ASSUMES AND RELIES ON THE CORRECT FUNCTIONING OF THE KERNEL -^ 
ANOTHER "LAYER" 



CONSTRUCT A MORE SOPHISTICATED LAYER WHICH ASSUMES AND RELIES ON 
THE CORRECT FUNCTIONING OF THE PREVIOUS MACHINES 



ETC 



THE "LAYERS" OF THE MULTICS SUPERVISOR PARTIALLY MAP INTO THE ABOVE 
SUBSYSTEMS 



a THE FOLLOWING DIAGRAM REPRESENTS THIS MAPPING: 
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THE MAJOR SUPERVISOR SUBSYSTEMS 




THE MULTICS SUPERVISOR 

COMPONENTS ARE ASYNCHRONOUSLY INVOKED 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 



B FUNCTION 



IMPLEMENT THE PER PROCESS VIRTUAL MEMORY 



B BASIC PHILOSOPHY 



AS A NEWLY LOGGED IN USER ATTEMPTS TO TOUCH VARIOUS SEGMENTS A 
CONSIDERABLE AMOUNT OF MANAGEMENT INFORMATION MUST BE 
(TRANSPARENTLY) FOUND AND/OR COMPUTED BEFORE THE USER'S 
REFERENCE IS ACTUALLY ACCOMPLISHED 



FOR EVERY SEGMENT REFERENCED BY THE USER, THE SUPERVISOR: 

I ASSIGNS A SEGMENT NUMBER (FOR REASON OF HARDWARE ADDRESSING), 



H RECORDS (REMEMBERS) THE MANAGEMENT INFORMATION (FOR REASON OF 
SOFTWARE EFFICIENCY AND CONTROL) 



8 SUCH SEGMENTS ARE SAID TO BE "KNOWN TO THE PROCESS' 



THE MANAGEM-ENT INFORMATION IS MAINTAINED ON A PER PROCESS BASIS 
IN THREE COMPLEMENTING AREAS: DSEG, KST, AND RNT 
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NAME SPACE/ADDRESS SPACE MANAGEMENT 



MANAGES TWO DISTINCT SETS OF INFORMATION: 

I ADDRESS SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND 
THE SEGMENTS THEMSELVES 

NAME SPACE - CORRESPONDENCE ' BETWEEN SEGMENT NUMBERS AND NAMES 
THE USER REFERS TO THEM BY 



CALLS DIRECTORY CONTROL TO LOCATE SEGMENTS INITIALLY 



i NAME SPACE / ADDRESS SPACE MANAGEMENT IS INVOKED BY SUBROUTINE 
CALLS, AND BY LINKAGE FAULTS (THE "DYNAMIC LINKER") 



B PRINCIPAL USER INTERFACES 



COMMAND LEVEL 



initiate, terminate, terminate_segno, terminate_ref_name , 
terminate_sing.le_ref_name , iist_ref_name 

THE COMMAND PROCESSOR ITSELF - WHICH USES THESE SERVICES TO 
LOCATE COMMANDS 



n SUBROUTINE LEVEL 

I hcs_$initiate, hcs_$initiate_count__, hcs__$terminate_f lie , 
hcs_$terminate_seg, hcs__$terminate_name, 
hcs_$terminate_nonanie , term__ 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 

B MAJOR DATA BASES 

I DESCRIPTOR SEGMENT (DSEG) - ONE PER PROCESS 

D SEGMENT DESCRIPTOR WORD (SDW) - ONE PER KNOWN SEGMENT 

J DEFINES THE USER'S ADDRESS SPACE TO THE HARDWARE 

KNOWN SEGMENT TABLE (KST) - ONE PER PROCESS 

I KNOWN SEGMENT TABLE ENTRY (KSTE) - ONE PER KNOWN SEGMENT 
(EXCEPT SUPERVISOR SEGMENTS) 

DEFINES THE USER'S ADDRESS SPACE TO THE SUPERVISOR AND THE 
USER 

I) r'jir'Tj vcfni? 5k c e n/^ T » Tic c i r-rcc'D ' c cvrrurcvcv MTTwnWTS MTTOI TW. CPflMP'WT 

CONTROL ATTRIBUTES OF THAT SEGMENT 

i THE SEARCH FOR AN AVAILABLE KSTE DETERMINES A SEGMENT'S 
NUMBER 

REFERENCE NAME TABLE (RNT) - ONE PER EACH RING IN EACH PROCESS 

NOT A SEGMENT - KEPT AS A REGION ALLOCATED IN THE "LINKAGE 
AREA" FOR EACH RING 

REFERENCE NAME TABLE ENTRY (RNTE) - ONE PER REFERENCE NAME 

USED BY THE DYNAMIC LINKER TO IMPLEMENT THE 
"initiated_segments" SEARCH RULE 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 



DEFINES THE USER'S NAME SPACE TO THE USER 



NAME SPACE MAY BE DIFFERENT IN DIFFERENT RINGS OF THE SAME 
PROCESS 
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DIRECTORY CONTROL 



B FUNCTION 



DIRECTORY CONTROL IS A SET OF HARDCORE MODULES RESPONSIBLE FOR 
THE. MAINTENANCE OF THE MULTICS DIRECTORY STRUCTURE == ISs THE 
HIERARCHY 



ITS TASKS INCLUDE CREATING, MANIPULATING AND INTERPRETING THE 
CONTENTS OF DIRECTORY SEGMENTS, TO INCLUDE: 

I ACCESS CONTROL LISTS (ACL'S), NAMES, AND VTOCE POINTERS OF 

ENTRIES DESCRIBED THEREIN 



ONLY DIRECTORY CONTROL IS ALLOWED TO ALTER THE CONTENTS OF 
DIRECTORY SEGMENTS 



DIRECTORY CONTROL IMPLICITLY RELIES UPON THE SERVICES OF OTHER 
SUBSYSTEMS SUCK A.S SEGMENT CONTROL AND PAGE CONTROL , AND ALSO 
INVOKES THEM DIRECTLY BY SUBROUTINE CALL 



DIRECTORIES ARE SIMPLY SEGMENTS TO THESE SUBSYSTEMS, 



B DIRECTORY CONTROL IS INVOKED ONLY BY SUBROUTINE CALLS 



E PRINCIPAL USSR INTERFACES 
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DIRECTORY CONTROL 



create, create_dir, link, set_acl, delete_acl, status, list, 
add name, rename 



SUBROUTINE LEVEL 

I hcs_$append_branch, hcs_$add_acl_entries, hcs_$append_link, 
hcs_$delete_acl_entries, hcs_$status_, hcs_$chname_f ile 



a MAJOR DATA BASES 



DIRECTORY SEGMENTS 



CONTAIN THE ATTRIBUTES AND OTHER INFORMATION ABOUT THEIR 
SEGMENTS (NEEDED TO FIND SEGMENTS, RETURN STATUS INFORMATION, 
AND BUILD VTOCS'S AT SEGMENT CREATION) 



THE DIRLOCKT SEG 



SEGMENT WHERE DIRECTORY LOCKING IS MANAGED 
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VOLUME MANAGEMENT 



B FUNCTION 



VOLUME MANAGEMENT IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
AND LOGICAL VOLLISS 



I ITS TASKS INCLUDE: 

D ACCEPTANCE AND DEMOUNTING OF PHYSICAL VOLUMES 



MAINTAINING THE ASSOCIATION BETWEEN PHYSICAL VOLUMES, LOGICAL 
VOLUMES, AND DISK DRIVES 



C ENSURING THE INTEGRITY OF VOLUME CONTENTS 



MAKING VOLUME CONTENTS ACCESSABLE TO PAGE CONTROL (PAGES) AND 
SEGMENT CONTROL (VTOC ENTRIES) 



VOLUME MANAGEMENT IS INVOKED ONLY BY SUBROUTINE CALLS 
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VOLUME MANAGEMENT 



a MAJOR DATA BASES 



J PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 

PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE KNOWN 
TO THE SYSTEM 

B EACH PVTE IDENTIFIES A DRIVE'S DEVICE NUMBER, SUBSYSTEM NAME, 
DEVICE TYPE, AND INFORMATION ABOUT THE PHYSICAL VOLUME 
CURRENTLY MOUNTED 

1 USED TO MAP REFERENCES TO PAGES OF SEGMENTS, INTO AN I/O 
REQUEST TO THE CORRECT DISK DRIVE " 



LOGICAL VOLUME TABLE (LVT) - ONE PER SYSTEM 

J LOGICAL VOLUME TABLE ENTRY (LVTE) - ONE PER MOUNTED LOGICAL 
VOLUME 

n T»»/^TT- r TTmci /^r\vTm»TVTc muc rrsmnr ^rnr rruiv m onTUTS'O? TO MF.MRP.'R 
PVTE'S, AIM CLASS LIMITS, ETC. 

I USED TO DETERMINE A USER'S ACCESS TO A LOGICAL VOLUME 
(PRIVATE OR PUBLIC) AND TO LOCATE MEMBER PHYSICAL VOLUMES 



VOLUME HEADER - ONE PER PACK 

I VOLUME LABEL (REGISTRATION AND ACCEPTANCE INFORMATION) 

I VOLUME MAP (OCCUPIED/VACANT INFORMATION FOR VOLUME CONTENTS) 
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VOLUME MANAGEMENT 



I RECORD STOCKS - ONE PER MOUNTED VOLUME 

B ONLINE CACHE OF INFORMATION ABOUT USED / UNUSED RECORDS ON 
THE VOLUME 

I THIS INFORMATION IS DERIVED FROM THE VOLUME MAP, BUT KEPT 
ONLINE TO AVOID THE NECESSITY OF REFERRING TO THE VOLUME MAP 
ON DISK EVERY TIME A RECORD IS ALLOCATED OR FREED 

WHEN THE CACHE BECOMES COMPLETELY EMPTY OR COMPLETELY FULL , 
IT MUST BE UPDATED FROM/TO DISK - A PROTOCOL ENSURES THAT THE 
COPY ON DISK IS ALWAYS CONSISTENT 

' i PROVIDED BY VOLUME MANAGEMENT, BUT USED BY PAGE -' CONTROL 



I VTOCE STOCKS - ONE PER VOLUME 

I SIMILAR TO RECORD STOCKS, BUT MAINTAINS INFORMATION ABOUI 

n PROVIDED BY VOLUME MANAGEMENT, BUT USED BY SEGMENT CONTROL 



B PHYSICAL VOLUME HOLD TABLE (PVHT) - ONE PER SYSTEM 

RECORDS THE COMMENCEMENT OF COMPOUND I/O OPERATIONS UPON A 
PHYSICAL VOLUME 

B THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE 
SUCH AN OPERATION IS IN PROGRESS 
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SEGMENT CONTROL 



FUNCTION 



SEGMENT CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF LOGICAL 
MEMORY 



ITS TASKS INCLUDE: 



J MAINTAINING THE DISK RESIDENT MAPS OF SEGMENTS (IE: THEIR 
VTOCE'S) 



SEGMENT CREATION, TRUNCATION AND DELETION 

SEGMENT ACTIVATION AND DEACTIVATION (ASTE MULTIPLEXING) 



SEGMENT CONTROL CAN BE INVOKED • EITHER BY SUBROUTINE CALLS OR BY 
SEGMENT FAULTS 



a BASIC PHILOSOPHY OF ACTIVATION/DEACTIVATION 



OF ALL SEGMENTS RESIDENT WITHIN THE SYSTEM'S MOUNTED PHYSICAL 
VOLUMES, ONLY A SMALL SUBSET WILL REQUIRE ACCESSING AT ANY ONE 
TIME. SUCH SEGMENTS WILL BE CALLED "ACTIVE SEGMENTS" 



B A PART OF MAIN MEMORY, CALLED THE "ACTIVE SEGMENT TABLE" (AST), 
WILL BE RESERVED TO HOLD MANAGEMENT INFORMATION FOR THESE ACTIVE 
SEGMENTS (IDENTITY, PVT INDEX, LOCATION OF PAGES., ETC.) 
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SEGMENT CONTROL 



AS SEGMENTS . FALL INTO DISUSE, THEIR "MANAGEMENT INFORMATION" IN 
THE AST WILL BE REPLACED WITH INFORMATION OF OTHER SEGMENTS 
REQUIRING ACTIVATION 



B USER INTERFACE 

i COMMAND LEVEL 

fl create, delete, truncate, etc, 



I SUBROUTINE LEVEL 

I hcs_$append_branch, hcs_$append_b.ranchx, hcs_$delentry_seg, 
hcs_$deientry_f ile, hcs_$truncate_seg, hcs_$truncate_f ile, 
hcs_$f orce_write, etc 



B MAJOR DATA BASES 

I SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM, SHARED WITH PAGE 
CONTROL. ONE MAJOR COMPONENT IS "OWNED" BY SEGMENT CONTROL: 

J ACTIVE SEGMENT TABLE (AST)' - ONE PER SYSTEM 

B THE AST IS A LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 

ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 

i ASTES CONTAIN PHYSICAL VOLUME ID'S (PVID'S) AND VTOC 
INDEX'S (VTOCZ'S) OF SEGMENTS. NEEDED BY SEGMENT CONTROL 
TO FIND THE SEGMENT ON DISK (HARDWARE) 
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SEGMENT CONTROL 

B AST HASH TABLE 

B ALLOWS EFFICIENT SEARCHING OF ASTE'S 

■ B LOGICALLY PART OF THE AST, BUT ELSEWHERE FOR HISTORICAL 
REASONS 

B DIRECTORY SEGMENTS 

B CONTAIN LOCATIONS AND ATTRIBUTES OF SEGMENTS. LOCATION 
INFORMATION FROM DIRECTORY SEGMENTS IS PROVIDED TO SEGMENT 
CONTROL BY DIRECTORY CONTROL 

B VOLUME TABLE OF CONTENTS {VTOC) - ONE PER PHYSICAL VOLUME 

B VOLUME TABLE OF CONTENTS ENTRY (VTOCE) - ONE PER 
DISK-RESIDENT SEGMENT 

n EACH VTOCE CONTAINS THE SEGMENT'S UNIQUE ID, CURRENT LENGTH, 
FILE MAP, ETC (NEED TO BUILD ASTE'S AND PT'S) 

B VTOCES ARE READ AND WRITTEN ONLY BY SEGMENT CONTROL 

B VTOCE STOCKS - FROM VOLUME MANAGEMENT 

I USED WHEN CREATING AND DELETING VTOCES FOR SEGMENTS 
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PAGE CONTROL 



B FUNCTION 



|. PAGE CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 



MEMORY TO INCLUDE THE MULTIPLEXING OF MAIN MEMORY FRAMES, AND 
THE MANAGEMENT OF DISK STORAGE 



ITS TASKS INCLUDE: 



TRANSFERRING THE PAGES OF SEGMENTS BETWEEN THE MEMORY 
DEVICES, AND RECORDING THE LOCATION OF "THE" COPY OF THESE 
PAGES 



REPORTING THE STATUS AND FILE MAPS OF SEGMENTS TO SEGMENT 
CONTROL 



PAGE CONTROL I S LARGELY CODED IN MULTICS ASSEMBLER LANGUAGE 
(ALM) 



PAGE CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
PAGE FAULTS 



THERE ARE NO EXPLICIT USER INTERFACES TO PAG5 CONTROL 
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PAGE CONTROL 



B BASIC PHILOSOPHY 



II OF ALL THE SEGMENTS ACTIVE AT A GIVEN TIME, ONLY A SMALL SUBSET 
OF THEIR TOTAL PAGES WILL BE REQUIRED FOR ACCESSING 



B PAGES WILL BE READ INTO MAIN MEMORY AS THEY ARE REQUIRED 



THE READING OF A PAGE INTO MAIN MEMORY WILL (PROBABLY.) REQUIRE 
THE EVICTION OF A PREVIOUSLY REQUIRED PAGE 



THE CHOICE OF A PAGE FOR EVICTION WILL BE BASED ESSENTIALLY UPON 
A "LEAST RECENTLY USED" CRITERIA 



an' EVICTED PAGE NEED BE WRITTEN BACK TO DISK ONLY IF IT WAS 
MODIFIED DURING ITS RESIDENCY IN MAIN MEMORY 



s MAJOR DATA BASES 



PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM. PROVIDED 3'i 
VOLUME MANAGEMENT 

O PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE 
CONFIGURED 



I EACH PVTE CONTAINS: 

D THE DEVICE ID (DISK DRIVE ID) AND THE ID OF THE PHYSICAL 
VOLUME (DISK PACK) CURRENTLY MOUNTED 
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PAGE CONTROL 



THE NUMBER OF RECORDS LEFT UNALLOCATED ON ' THE PHYSICAL 
VOLUME, POINTER TO THE RECORD STOCK, ETC 



RECORD STOCKS - ONE PER MOUNTED PHYSICAL VOLUME, PROVIDED BY 
VOLUME MANAGEMENT 



CONTAINS AN IN-MEMORY CACHE OF THE IN-USE STATUS OF RECORDS 
ON THE VOLUME, FROM THE VOLUME MAP, USED WHEN ALLOCATING OR 
FREEING PAGES 



ACCESSED BY A COMPLEX MECHANISM WHICH USES NORMAL PAGE I/O 
BUT HAS A PROTOCOL TO ENSURE SYNCHRONIZATION OF DISK CONTENTS 
AND RECORD STOCK CONTENTS 



SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM. SHARED WITH 
SEGMENT CONTROL. CONTAINS THE FOLLOWING FIVE DATA BASES USED BY 
PAGE CONTROL : 



SYSTEM SEGMENT TABLE (SST) HEADER - ONE PER SYSTEM 

I CONTAINS A LARGE NUMBER OF COUNTERS AND POINTERS VITAL TO 
THE MAINTENANCE AND METERING OF THE STORAGE SYSTEM 

B CONTAINS LOCKWORDS USED TO SYNCHRONIZE PAGE CONTROL AND 
SEGMENT CONTROL OPERATIONS 



CORE MAP - THE core_map SEGMENT - ONE PER SYSTEM 

J CORE MAP ENTRY (CME) - ONE PER FRAME (1024 WORDS) OF 
CONFIGURED MAIN MEMORY 

EACH CME REPRESENTS A FRAME OF MAIN MEMORY AND IDENTIFIES 
THE CURRENT OCCUPANT OF THAT FRAME 
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PAGE CONTROL 



NOT PART OF THE SST SEGMENT ANY MORE, BUT LOGICALLY PART 
OF THE SST 



B ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 

J! ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 
I LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 



PAGE TABLES (PT) - ONE PER ACTIVE SEGMENT, THE OTHER HALF OF 
EACH ASTE 

B PAGE TABLE WORD (PAGE PTW) - EITHER 4, 16, 64, OR 256 PER 
PAGE TABLE 

B EACH PTW DEFINES THE CURRENT LOCATION OF A PAGE OF THE 
SEGMENT: DISK, MAIN MEMORY ADDRESS, OR NULL 
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PAGE CONTROL 



THE MULTICS FILE SYSTEM 
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TRAFFIC CONTROL 



B FUNCTION 



TRAFFIC CONTROL {OR THE "TRAFFIC CONTROLLER") IS RESPONSIBLE FOR 
MANAGING THE ASSIGNMENT OF PHYSICAL PROCESSORS TO MULTICS 
PROCESSES AND IMPLEMENTING THE SYSTEM'S WAIT/NOTIFY AND 
INTERPROCESS COMMUNICATION PRIMITIVES 



THE FUNCTIONS ASSUMED BY THE TRAFFIC CONTROLLER ARE KNOWN AS 
MULTIPROGRAMMING, MULTIPROCESSING, SCHEDULING, DISPATCHING, 
PROCESSOR MANAGEMENT, AND INTERPROCESS COMMUNICATION. 



ITS MAJOR FUNCTION IS ALLOWING PROCESSES TO AWAIT THE COMPLETION 
OF FILE SYSTEM OPERATIONS, SUCH AS PAGE I/O 



TRAFFIC CONTROL CAN BE INVOKED BY SUBROUTINE CALLS AND 
INTERRUPTS 



THERE ARE NO IMPORTANT USER SUBROUTINE INTERFACES, BUT THERE ARE 
PRIVILEGED SUBROUTINE INTERFACES FOR PROCESS CREATION, 
ADJUSTMENT OF SCHEDULING PARAMETERS, ETC. 



B MAJOR DATA BASES 



TC_DATA SEGMENT - ONE PER SYSTEM. CONTAINS THE FOLLOWING FOUR 
DATA BASES: 



TC_DATA HEADER - ONE PER SYSTEM 

B CONTAINS VARIOUS METERS, COUNTERS AND POINTERS USED BY THE 
TRAFFIC CONTROLLER 
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TRAFFIC CONTROL 



ACTIVE PROCESS TABLE (APT) - ONE PER SYSTEM 

S' ACTIVE PROCESS TABLE ENTRY (APTE) - ONE OCCUPIED PER 
ACTIVE PROCESS (TOTAL NUMBER IS DETERMINED BY CONFIG DECK) 

S EACH APTE CONTAINS VARIOUS ATTRIBUTES OF AN ACTIVE PROCESS 
INCLUDING THE PROCESS ID, STATE, THE VALUE OF ITS 
DESCRIPTOR BASE REGISTER (DBR) , SCHEDULING PARAMETERS, AND 
A POINTER TO THE PROCESS'S ITT ENTRIES 

THE APTE CONTAINS ALL INFORMATION THE SUPERVISOR NEEDS TO 
KNOW ABOUT A PROCESS WHEN THE PROCESS IS NOT RUNNING 



INTERPROCESS TRANSMISSION TABLE (ITT) - ONE PER SYSTEM 

O ITT ENTRY - ONE OCCUPIED PER OUTSTANDING IPC WAKEUP 

B A QUEUE FOR TEMPORARILY STORING IPC WAKEUP INFORMATION 
(CHANNEL NAME, RANDOM DATA, PROCESS ID, ETC) 

WORK CLASS TABLE (WCT) - ONE PER SYSTEM 

WORK CLASS TABLE ENTRY (WCTE) - ONE PER WORKCLASS 

EACH WCTE CONTAINS ADMINISTRATOR DEFINED PARAMETERS OF THE 
WORKCLASS, VARIOUS METERS AND POINTERS 
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FAULT AND INTERRUPT HANDLING 



B FUNCTION 



RESPONSIBLE FOR HANDLING ALL EXCEPTIONS IN A CPU WHETHER 
INTERNAL TO THE PROCESSOR (REFERRED TO AS FAULTS) OR EXTERNAL 
(REFERRED TO AS INTERRUPTS) 



ESTABLISHES THE SUPERVISOR ENVIRONMENT AT FAULT AND INTERRUPT 
TIME. SAVES THE MACHINE CONDITIONS AND TRANSFERS TO THE 
APPROPRIATE HANDLER 



MAJOR COMPONENTS: THE FAULT INTERCEPT MODULE (fim), WI RED-FAULT 
INTERCEPT MODULE (wired_fim), I/O INTERRUPT HANDLER 
( io_interrupt ) , sys_trouble, page_fault 



8 MAJOR DATA BASES 



I) TMTTrppTTPT VP.rTnTje; - nMTT c;P.T PtP.V ejvqTPM mTT?F■n^ 



D INTERRUPT PAIR (2 INSTRUCTIONS) - ONE PAIR ■ PER DEFINED 
INTERRUPT TYPE 



LOCATED AT ABSOLUTE ADDRESS 0. A HARDWARE RECOGNIZED DATA 
BASE 



DESCRIBE WHERE TO SAVE THE CONTEXT, AND WHERE TO TRANSFER TO" 
TO PROCESS THE INTERRUPT (ALWAYS io_interrupt ) 
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FAULT AND INTERRUPT HANDLING 



FAULT VECTORS - ONE SET PER SYSTEM (WIRED) 



I VECTOR PAIR {2 INSTRUCTIONS) - ONE PAIR PER DEFINED FAULT 
TYPE 



LOCATED AT ABSOLUTE ADDRESS 100 (OCTAL) IMMEDIATELY ABOVE THE 
INTERRUPT VECTORS. A HARDWARE RECOGNIZED DATA BASE 



B DESCRIBE WHERE TO SAVE THE CONTEXT, AND WHERE TO TRANSFER TO 
TO PROCESS THE FAULT (fim, wired_fim, page_fault) 



PROCESS DATA SEGMENT (PDS) - ONE PER PROCESS J[WI RED WHEN 

ELIGIBLE) ^"7 

S CONTAINS PROCESS RELEVANT INFO SUCH AS PROCESS ID, USER ID, 
HOME/WORKING/PROCESS DIRECTORIES, AIM CLASSIFICATION, INITIAL 
RING, ETC 



CONTAINS ALL INFORMATION ABOUT tHE PROuESa NEEDED BY TKt 
SUPERVISOR CODE WHEN THE PROCESS IS RUNNING 



CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH CAN RESULT IN GIVING UP THE PROCESSOR: PAGE FAULTS, 
SEGMENT FAULTS, AND ALL FAULTS NOT HANDLED BY THE SUPERVISOR 



PROCESSOR DATA SEGMENT (PRDS) - ONE PER CONFIGURED CPU (WIRED) 



SERVES AS RING-ZERO STACK FOR PAGE CONTROL AND TRAFFIC 
CONTROL 



ALSO CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH USUALLY DO NOT MEAN GIVING UP THE PROCESSOR: CONNECT 
FAULTS AND INTERRUPTS. 
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II FIM_TABLE 



FAULT AND INTERRUPT HANDLING 



^f^ cr\ (>^ Ce 1\V T CX^Xt . 



A TABLE IN THE FIM PROGRAM WHICH DESCRIBES THE ACTION TO BE 
TAKEN FOR VARIOUS TYPES OF FAULTS 
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SYSTEM . INITIALIZATION Su^f^^>S>Or ^ \r^^ ^nn^P' ^b 

S FUNCTION '5">?) O o/opj ^o J/^^«^'. t <.:-n(c,^^ 

S PREPARE THE SYSTEM TO OPERATE, ' STARTING FROM A COMPLETELY EMPTY _^ ^^^ 
MACHINE QjVi^^'b '^^'^^ 

SWflP ^*- or r.-^Kv^/i?)- 

B READS TN SUPERVISOR PROGRAMS FROM SYSTEM TAPE, SNAPS LINKS 
BETWEEN SUPERVISOR COMPONENTS, VERIFIES AND INITIALIZES HARDWARE 
CONFIGURATION, SETS UP SYSTEM DATABASES, ACCEPTS STORAGE SYSTEM 
DISKS AND PREPARES THEM FOR USE BY THE FILE SYSTEM 



MOST -PROGRAMS IN SYSTEM INITIALIZATION ARE DELETED AFTER 
INITIALIZATION IS COMPLETE, o^jy -f^^ jrpcl^v^- '^ ^of\. 



SUPERVISOR PROGRAMS ARE LOADED IN THREE "COLLECTIONS", EACH OF 
WHICH DEPENDS ON THE MECHANISMS SET UP BY THE PREVIOUS ONE 



B MAJOR DATA BASES 



THESE DATA BASES ARE ALL BUILT DURING THE PROCESS OF 
INITIALIZATION (EXCEPT FOR THE CONFIG DECK) AND KEPT AFTER 
INITIALIZATION IS FINISHED ftsr ^e |,oo)cx ^^c. ' 



S SEGMENT LOADING TABLE (>sll>slt) 

I CONTAINS AN ENTRY DESCRIBING THE ATTRIBUTES OF EACH SEGMENT 
IN THE SUPERVISOR 
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SYSTEM INITIALIZATION 



NAME TABLE {>sll>name_table) 

CONTAINS A LIST OF NAMES FOR EACH OF THE SEGMENTS IN THE 
SUPERVI SOR 

DEFINITIONS SEGMENT (>sll>def initions_) 

CONTAINS THE DEFINITIONS SECTIONS FOR ALL THE -SEGMENTS IN THE 
SUPERVISOR, WHICH ARE USED IN ORDER TO SNAP LINKS BETWEEN THE 
SUPERVISOR MODULES 



CONFIG DECK (>sll>conf ig__deck ) 

I CONTAINS A DESCRIPTION OF THE HARDWARE CONFIGURATION AND 
CERTAIN SOFTWARE PARAMETERS 

PROVIDED TO SYSTEM INITIALIZATION BY BOS 



SHUTDOWN ~ TERMINATES THE ACTIVITIES OF THE SYSTEM IN AN ORDERLY 
FASHION 



TWO TYPES OF SHUTDOWN: 



NORMAL ~ REQUESTED BY THE INITIALIZER, RUNS IN THE USUAL 
SUPERVISOR ENVIRONMENT 

EMERGENCY — USED AFTER A CRASH, MUST MAKE THE SUPERVISOR 
ENVIRONMENT OPERABLE BEFORE PROCEEDING 
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SYSTEM INITIALIZATION 



BOTH TYPES EXIST PRIMARILY TO SHUT DOWN THE FILE SYSTEM ~ THAT 
IS, TO WRITE ALL DATA IN MEMORY INTO ITS PROPER HOME ON DISK 

I INCLUDES PAGES OF SEGMENTS, VTOCES , VOLUME AND VTOC MAPS 



SHUTDOWN ESSENTIALLY RUNS THE STEPS OF INITIALIZATION BACKWARDS, 
BUT WITH A LOT OF SHORTCUTS 
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FILE SYSTEM SALVAGERS 



S FUNCTION 



ENSURE THE CONSISTENCY OF THE FILE SYSTEM DATABASES AND PERFORM 
PERIODIC PREVENTIVE MAINTENANCE OPERATIONS 



B THERE ARE SEVERAL SALVAGERS, EACH WITH A DIFFERENT FUNCTION 



BECAUSE OF THE COMPLICATED INTERACTIONS THEY HAVE WITH THE REST 
OF THE FILE SYSTEM, THE SALVAGERS ARE PERHAPS THE MOST 
COMPLICATED SINGLE PROGRAMS IN THE SUPERVISOR 



SOME SALVAGING IS DONE AUTOMATICALLY, WHEN THE SYSTEM DETECTS AN 
INCONSISTENCY. OTHER SALVAGE OPERATIONS ARE EXPLICITLY 
REQUESTED, BY PRIVILEGED USERS. 



EXCEPT FOR SUPERVISOR BUGS, THE ONLY TIME DAMAGE OCCURS THAT 
REQUIRES SALVAGING TO FIX IS AFTER A CRASH WHERE EMERGENCY 
SHUTDOWN FAILS 



s THE SALVAGERS: 



DIRECTORY SALVAGER 



CORRECTS INCONSISTENCIES IN DIRECTORY SEGMENTS BY REBUILDING 
THEM 



THIS IS THE ONLY SALVAGER INVOKED AUTOMATICALLY IN USER 
PROCESSES: ANY ATTEMPT TO LEAVE RING ZERO WITH A DIRECTORY 
LOCKED FOR WRITING WILL CAUSE IT TO BE SALVAGED 
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FILE SYSTEM SALVAGERS 



I DIRECTORY SALVAGING ALSO RECLAIMS WASTED SPACE IN THE 
DIRECTORY, AND IS RUN PERIODICALLY TO COMPACT DIRECTORIES , 



[ QUOTA SALVAGER 

I CORRECTS INCONSISTENCIES IN THE QUOTA SYSTEM 



PHYSICAL VOLUME SCAVENGER f v y^ ^ Vol ^ ^ f^a(^ L \/"^0C ■? K/l^^ 

I RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION .FROM THE 
VTOCES ON A VOLUME, THEREBY RECLAIMING ANY RECORDS OR VTOCES 

WHICH MIGHT HAVE BEEN LOST 

I RUNS ENTIRELY ONLINE WHILE THE SYSTEM IS UP FOR USERS (NEW IN 
MRlO.l) 

I THIS TYPE_ OF DAMAGE IS USUALLY BENIGN, SO RUNNING THE 
SCAVENGER CAN BE DELAYED. 



'PHYSICAL VOLUME SALVAGER 

RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION 



RUNS ONLY DURING INITIALIZATION, AND THEREFORE DELAYS CRASH 
RECOVERY 



NOW USED ONLY FOR RARE CASES WHERE THERE IS NOT ENOUGH FREE 
SPACE LEFT FOR THE SCAVENGER TO RUN. IN THESE RARE CASES, IT 
IS INVOKED AUTOMATICALLY BY SYSTEM INITIALIZATION. 



SWEEP PV 



"^ ' ' ^' .^ r A.J .r \ 



O C Au -L \ 
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FILE SYSTEM SALVAGERS 



DELETES UNUSED VTOC ENTRIES WHICH HAVE "NO DIRECTORY ENTRY 
POINTING TO THEM 



RUNS ENTIRELY IN USER RING, EXCEPT FOR ACTUALLY READING VTOC 
ENTRIES AND DIRECTORY ENTRIES 



O PURELY A HOUSEKEEPING FUNCTION, AND RUN ONLY RARELY, 
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METERING & TUNING 



WHILE NOT A SUBSYSTEM ITSELF, METERING AND TUNING IS A POLICY AND 
CAPABILITY COJ®dON TO ALL OF THE SUPERVISOR'S SUBSYSTEMS 



B FUNCTION 



METERING {CONSISTS OF THREE ACTIVITIES) 



ACCUMULATING DATA: THIS ■ IS PERFORMED THROUGHOUT THE 
SUPERVISOR BY CODE WHICH 

I RECORDS THE NUMBER OF TIMES AN EVENT HAPPENS- OR A 
PARTICULAR PIECE OF CODE IS EXECUTED; AND/OR 

J RECORDS THE TIMS REQUIRED TO PERFORM A TASK 

SUCH DATA IS STORED IN AREAS REFERRED TO AS "METERING 
CELLS" • 



EXTRACTING DATA: THIS IS PERFORMED BY NUMEROUS METERING 
COMMANDS WHICH (WHEN INVOKED) 

I READ AND STORE THE CURRENT VALUES OF RELEVANT METERING 
CELLS 



REPORTING THE DATA: THIS IS PERFORMED BY THE METER COMMANDS 
WHICH (WHEN INVOKED) 

COMPARE CURRENT METERING CELL VALUES WITH PREVIOUSLY READ 
VALUES . 

J PERFORM THE APPROPRIATE ARITHMETIC COMPUTATIONS UPON THE 
DATA IN ORDER TO ARRIVE AT THE DESIRED STATISTIC 

P ARRANGE THE DATA IN A USEFUL FORMAT (A REPORT OR DIAGRAM) 
AND PRINT IT 
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METERING & TUNING 



B TUNING 

i CHANGING THE SYSTEM'S OPERATING PARAMETERS AND /OR 

CONFIGURATION BASED UPON THE DATA AND INSIGHTS FROM THE 
SYSTEM'S METERS 



s MAJOR DATA .BASES 



S SST HEADER, TC__DATA HEADER, ETC. 
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INITIALIZER. SYSDAEMON 

B FUNCTION 

THE SYSTEM'S INITIALIZATION, ADMINISTRATIVE AND CONTROL PROCESS 
(Initializer. SysDaemon. z) , RESPONSIBLE FOR: 

INITIALIZING THE OPERATING SYSTEM AT BOOTLOAD, FOLLOWING 
SUCCESSFUL INITIALIZATION OF THE SUPERVISOR 

1 ANSWERING SERVICE (login and logout) 
B PROCESS CREATION AND DESTRUCTION 

MESSAGE COORDINATOR (DAEMON COORDINATION) 

SYSTEM ADMINISTRATION .FUNCTIONS 

1 SYSTEM ACCOUNTING FUNCTIONS 



E MAJOR DATA BASES, ALL KEPT IN >scl 



ANSWER TABLE 



ABSENTEE USER TABLE 



II DAEMON USER TABLE 
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INITIALIZER. SYSDAEMON 



MASTER GROUP TABLE (MGT) 



I CHANNEL DEFINITION TABLE (CDT) 



SYSTEM ADMINISTRATION TABLE (SAT) 



PERSON NAME TABLE (PNT) 



B PROJECT DEFINITION TABLES (PDT'S) 
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WHAT IS A PROCESS 



A MULTICS PROCESS IS A WELL DEFINED COLLECTION OF SEGMENTS, EACH 
WITH DEFINED ACCESS, OVER WHICH A SINGLE EXECUTION POINT IS FREE TO 
ROAM (I.E., FETCH INSTRUCTIONS AND MAKE DATA REFERENCES) 



THE ADDRESS SPACE OF A PROCESS IS THE ABOVE "COLLECTION OF 
SEGMENTS". SUCH SEGMENTS ARE SAID TO BE KNOWN TO THE PROCESS 



S EVERY LOGGED IN USER HAS A PROCESS 



VERY IMPORTANT CONCEPT: THE MULTICS SUPERVISOR RUNS IN THE USSR'S 
PROCESS (IE: IN THE USER'S ADDRESS SPACE), BUT IN A DIFFERENT RING 



A PROCESS TAKES ON THE IDENTITY OF THE SOFTWARE IT IS EXECUTING 
WHERE EVER IT GOES 



B WHEN A USER WISHES TO CREATE A SEGMENT, IT IS THE USER'S PROCESS 
WHICH EXECUTES THE SUPERVISOR CODE hcs_Sappend, CREATING THE 
SEGMENT 



A PROCESS CAN BE VIEWED AS A CONTINUAL FLOW OF EXECUTION 
FLUCTUATING BETWEEN DIFFERENT RINGS: PRIMARILY RING FOUR AND RING 
ZERO 
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WHAT IS A PROCESS 



PROCESS FLOW OF EXECUTION 



TIME 



ALL PROCEDURE CODE (WHETHER SUPERVISOR OR USER CODE) MUST HAVE A 
STACK FRAME CONTAINING ITS ARGUMENTS AND ENVIRONMENT DATA 



FOR REASONS OF SECURITY, MULTICS REQUIRES ONE STACK PER RING OF 
EXECUTION. WHEN EXECUTING RING "N" PROCEDURES, THERE WILL EXIST A 
RING "N" STACK CONTAINING STACK FRAMES FOR THESE PROCEDURES 
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STACK PER RING 
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Ct-^v 



PR6 



X 
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Xj 



FRAME 2 



FRAME 1 



STACK 
HEADER 
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v<A 



00 



fault 





FRAME 3 


FRAME 2 


FRAME 1 


STACK 
HEADER 



Sp<\ ^i^^ 230stack_0 
-^ (0.0.0) 

SEVERAL (10 30) 
PER SYSTEM. SHARED 




4t 231 stack _1 
(1.1,1) 
IN USER'S PROCESS 
DIRECTORY 





FRAME 5 


FRAME 4 


FRAME 3 


FRAME 2 


FRAME 1 


STACK 
HEADER 



# 234stack_4 
(4.4.4) 

IN USER'S PROCESS 
DIRECTORY 



* PR7 IS THE STACK BASE POINTER REGISTER. POINTS TO CURRENT STACK. HARDWARE LOADED WITH 
DBR.stack *a + RING. THE VALUE OF DBR .stack CAN CHANGE WITH EACH RELEASE. IT IS 23 IN MR10.1. 

• PRO IS THE STACK FRAME POINTER REGISTER. POINTS TO CURRENT STACK FRAME. 
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COOPERATING PROCESSES 



E ALL ACTIVE PROCESSES (INTERACTIVE, ABSENTEE, AND DAEMONS) APPEAR TO 
BE AUTONOMOUS AND INDEPENDENT OF ONE ANOTHER 



IN REALITY, ALL PROCESSES ARE CONTINUALLY COOPERATING, COMPETING 
AND SHARING 



D EXAMPLES OF COOPERATION 

1 VOLUNTARY 

THE SENDING AND ACCEPTING OF MESSAGES AND MAIL 

C PREPLANNED BY SYSTEM PROGRAMMERS 

1 EVERY PROCESS, BEFORE RELINQUISHING A PROCESSOR, CHOOSES 
THE MOST DESERVING REPLACEMENT AND EXECUTES THE CODE- WHICH 
DISPATCHES THE CHOSEN PROCESS 

EVERY PROCESS, WHEN RUNNING, WILL SERVICE ALL INTERRUPTS 
FIELDED BY ITS PROCESSOR. THESE INTERRUPTS ARE GENERALLY 
THE REPLIES TO THE REQUESTS OF OTHER PROCESSES (IE: THE 
ARRIVAL OF A PAGE REQUESTED SOME TIME EARLIER) 

J PREPLANNED BY APPLICATION PROGRAMMERS 

THE MULTICS TRANSACTION PROCESSOR IS COMPOSED OF MANY 
COOPERATING, INTER-DEPENDENT PROCESSES 



EXAMPLES OF COMPETITION 



ALL PROCESSES COMPETE FOR PROCESSOR TIME AND MAIN MEMORY 
RESOURCES 
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COOPERATING PROCESSES 



THIS COMPETITION IS HIGHLY REGULATED IN ORDER FOR ALL 
PROCESSES TO BE TREATED FAIRLY 



THE COMPETITION IS ALSO SUBJECT TO VERSATILE ADMINISTRATIVE 
CONTROLS 



EXAMPLES OF SHARING 



BY DESIGN, A SIGNIFICANT PART OF THE ADDRESS SPACE OF ALL 
PROCESSES IS IDENTICAL (THE SUPERVISOR SEGMENTS) 



BY DEFAULT, REFERENCES TO SEGMENT foo BY TWO DIFFERENT 
PROCESSES WILL RESULT IN REFERENCES TO THE SAME SEGMENT 
(LOGICALLY, PHYSICALLY, ACTUALLY AND ABSOLUTELY) 



THERE IS NO SEPARATE ENTITY IN MULTICS LIKE AN EXECUTIVE DOING 
THINGS ON BEHALF OF THE USER. THE Initializer . SvsDaemon IS NOT THE 
TIME-SHARE EXECUTIVE OF MULTICS 
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THE PL/I OPERATORS 



B OPERATORS ARE LANGUAGE DEPENDENT PIECES OF CODE WHICH IMPLEMENT 
HARDWARE OR OPERATING-SYSTEM DEPENDENT FUNCTIONS SUCH AS CALLING 
AND SIGNALLING 



CURRENTLY THERE ARE OPERATORS FOR PL/I, COBOL, AND BASIC. ALM AND 
FORTRAN SHARE THE PL/I OPERATORS 



S ALL OPERATORS IN MULTICS ARE PURE, SHARED AND RE-ENTRANT ALM CODE 



OPERATORS COULD BE GENERATED BY THE COMPILERS AND PLACED IN LINE 
WITH OTHER CODE, HOWEVER, THERE ARE DISADVANTAGES: 



SOME OPERATORS ARE TOO BULKY TO BE INCLUDED WITH EACH USE (SUCH 
AS COMPLICATED I/O STATEMENTS) 



SOME OPERATORS MIGHT CHANGE IN THE FUTURE (SUCH AS ENTRY AND 
RETURN SEQUENCES) 



OPERATORS ARE SIMILAR TO QUICK INTERNAL PROCEDURES IMPLEMENTING 
WHAT IS OFTEN CALLED "LIBRARY FUNCTIONS" IN OTHER OPERATING SYSTEMS 
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THE PL/I OPERATORS 



B INSTEAD OF PASSING ARGUMENT LIST, ARGUMENTS ARE USUALLY PASSED TO 
THE OPERATORS IN THE CPU'S REGISTERS 



INSTEAD OF BEING CALLED BY A PROCEDURE CALL, A SINGLE TRANSFER 
INSTRUCTION IS USED (tSxO or tsp3) 



THE PL/I OPERATORS IMPLEMENT THE SUPPORT FUNCTIONS FOR THE PL/I 
ENVIRONMENT 



8 SINCE A MULTICS PROCESS IS A PL/I ENVIRONMENT, THE PL/I OPERATORS 
ARE VITAL TO THE MULTICS SUPERVISOR (AND ANY OTHER PROGRAMS WRITTEN 
IN PL/I) 
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INTERFACES TO SYSTEM MODULES 



UNLIKE OTHER SUPERVISORS, THE MULTICS SUPERVISOR IS NOT SEQUENTIAL 
- THAT IS, THE CONCEPT OF "JOB FLOW" DOES NOT REALLY APPLY 



INSTEAD, THE SUBSYSTEMS PERFORM ASYNCHRONOUSLY, BEING 'INVOKED' 
BY THOSE PROCESSES WHO REQUIRE THEIR SERVICES 



THESE SUBSYSTEMS ARE INVOKED BY THE USER'S PROCESS IN ONE OF 
THREE WAYS: ■ 

EXPLICITLY - VIA A SUBROUTINE CALL OR A COMMAND 



IMPLICITLY - VIA A FAULT 



V> 



,^4 6v; 



^rr <jo9^;::^o.fcVi 50 w«5\ 'J^N^^^cA 5v^i,^^( 



5 IMPLICITLY - VIA AN INTERRUPT 



(^^- OVP 



r ^cvnJ'. 





SUPERVISOR 
SUBSYSTEM 




INTERRUPT SIDE 



CALL SIDE: SERVICES PERFORMED AS A RESULT OF EXPLICIT 

SUBROUTINE CALLS. LOCKS ARE NORMALLY 
WAIT LOCKS. 

FAULT SIDE: SERVICES PERFORMED AS A RESULT OF FAULTS. 

LOCKS ARE NORMALLY WAIT LOCKS. 

INTERRUPT SIDE: SERVICE PERFORMED AS A RESULT OF INTERRUPTS. 
LOCKS ARE LOOP LOCKS. 
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DEADLOCK PREVENTION 



B WHAT I S DEADLOCK? 



DEADLOCK CAN OCCUR IN ANY MULTI -PROGRAMMING ENVIRONMENT WHEN TWO 
OR MORE PROCESSES COMPETE RANDOMLY FOR SERIALLY REUSABLE 
RESOURCES 



THE CLASSIC EXAMPLE OF DEADLOCK IS THE "DEADLY EMBRACE" 




DEADLY EMBRACE 



• PROCESS A IS WAITING FOR A RESOURCE OWNED BY PROCESS B. 

• PROCESS B IS WAITING FOR A RESOURCE OWNED BY PROCESS A. 
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DEADLOCK PREVENTION 



B DEADLOCK SOLUTIONS 



DETECTION AND UNLOCKING 



SOME SYSTEMS EMPLOY' SCHEMES WHICH DETECT THE OCCURRENCE OF 
DEADLOCK AND "UNTANGLE" THE INVOLVED PROCESSES 



DETECTION SCHEMES ARE USUALLY DIFFICULT TO IMPLEMENT AND 
EXPENSIVE IN TERMS OF OVERHEAD 



THE ACT OF UNTANGLING THE INVOLVED PROCESSES USUALLY RESULTS 
IN AT LEAST ONE OF THEM LOSING RESOURCES, PRIORITY, OR EVEN 
ITS LIFE 



1] PREVENTION 

I MOST SYSTEMS ADOPT SOME FORM OF PREVENTION INSTEAD OF 
DETECTION 



II CHECKING: WHEREBY REQUESTS FOR RESOURCES ARE SCREENED FOR 
DEADLOCK POTENTIAL PRIOR TO ACCEPTANCE 

IMPOSED POLICY: WHEREBY REQUESTS FOR MORE THAN ONE 
RESOURCE MUST BE MADE: 

I TOGETHER AS ONE TOTAL REQUEST BEFORE THE "JOB" OR 
"JOB-STEP" COMMENCES (ALL OR NOTHING); OR 

SERIALLY, IN A FIXED, PRE-DEFINED ORDER 
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DEADLOCK PREVENTION 



>fJLTICS, IN GENERAL, ADOPTS THE FOLLOWING DEADLOCK PREVENTION 
SCHEME: 



USER ASSIGNABLE RESOURCES (SUCH AS TAPE DRIVES, CARD PUNCHES, 
ETC ) 

I WHEN THE USSR IS INTERACTIVE NO POLICY IS ENFORCED. THE USER 
IS INFORMED IF THE RESOURCE IS BUSY AND MAY EITHER TRY AGAIN 
OR GIVE UP 



WHEN THE USER IS NOT INTERACTIVE, THE "ALL" OR "NONE" 
APPROACH SHOULD. BE USED. THE AVAILABILITY OF ALL REQUIRED 
RESOURCES BECOMES THE DETERMINING FACTOR IN SCHEDULING THE 
USER {SEE THE "RESOURCE CONTROL PACKAGE") 



SHOULD A NON- INTERACTIVE USER ATTEMPT SERIAL REQUESTS FOR 
RESOURCES, A DEADLOCK SITUATION COULD POTENTIALLY ARISE AND 
EZIST UNTIL THE AUTOMATIC LOGOUT DUE TO INACTIVITY OCCURS 



USER ACCESSIBLE RESOURCES (SUCH AS FILES, DATA BASES, ETC) 



IN GENERAL, USER SEGMENTS IN THE' HIERARCHY POSE NO DEADLOCK 
PROBLEM SINCE THEY ARE A SIMULTANEOUSLY USABLE RESOURCE (IE: 
THERE IS NO DEFAULT CONCURRENCY MECHANISM ASSOCIATED WITH 
USER SEGMENTS) 



SEGMENTS MAY BE PROTECTED FROM POTENTIAL CONCURRENCY PROBLEMS 
THROUGH USE OF LOCK WORDS AND THE set_lock_ MECHANISM. THIS 
REQUIRES MUTUAL AGREEMENT AMONG ALL PROCESSES ACCESSING SUCH 
SEGMENTS 



SOME SEGMENTS SUCH AS THOSE USED BY THE MULTICS DATA BASE 
MANAGER (MD3M) , USE A "COMMITMENT /ROLLBACK" SCHEME 
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DEADLOCK PREVENTION 



SUPERVISOR RESOURCES (SUCH AS HARDCORE DATABASE) 

1 LOCKWORDS (OR SIMPLY "LOCKS") ARE USED IN MULTICS TO 
IMPLEMENT CONCURRENT ACCESS CONTROL IN THE MULTI -PROCESS 
ENVIRONMENT 



LOCKING CONCEPT 




UNLOCK 



UPDATE 



THE SUPERVISOR LOCKS ARE ARRANGED IN A PARTIAL 
CODING CONVENTION PREVENTS WAITING ON A LOCK IJ 
HAS A HIGHER LOCK LOCKED 



ORDER AND A 
THE PROCESS 



THIS PARTIAL ORDER IS DETERMINED BY AN ANALYSIS OF THE 
OPERATING SYSTEM'S BEHAVIOR. FOR EXAMPLE: SINCE A PAGE 
FAULT MAY PROPERLY OCCUR WHILE A PROCESS HAS THE ACTIVE 
SEGMENT TABLE (AST) LOCKED, AND PAGE FAULT HANDLING REQUIRES 
THE LOCKING OF THE PAGE TABLE LOCK, THE PAGE TABLE LOCK MUST 
BE PLACED "HIGHER" IN THE PARTIAL ORDER THAN THE AST LOCK 



TO THE DEGREE THAT THE SYSTEM , PROGRAMMERS OBEY THIS PARTIAL 
ORDER, A DEADLY EMBRACE CANNOT OCCUR WITHIN THE MULTICS 
SUPERVI SOR 
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MULTICS LOCKING HIERARCHY 



I/O MAILBOX 
.(LOOP) 



CONNECT 
(LOOP) 



v_ 



GLOBAL APT 

(MULTI-HEADER 

(LOOP) 



APT ENTRY CORE QUEUE DIS 



/ ^ 

K DATA OC 



(LOOP) 



(LOOP) 



\ 



(LOOP) 



OCDCM 
(LOOP) 



\ 



SYSERR DATA 
(LOOP) 

I 



IVICS QUEUE 
(LOOP) 



GLOBAL PAGE TABLE 
(LOOP/WAITI 



t 



VTOC BUFFER SEGMENT 
(WAIT) 



t 



ACTIVE SEGMENT TABLE 
(WAIT) 



t 



DIRECTORY LOCK TABLE 

(WAIT) 



f 



ROOT DIRECTORY 
(MULTI-READER, WAIT) 



t 



LOWER DIRECTORY 
(MULTI-READER, WAIT) 
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MISCELLANEOUS: lOAT, 101. 

SALV_DATA, RECONFIGURATION 

(WAIT) 



SYSERR LOG 

(WAIT) 



MCS CHANNEL 
(LOOP/WAIT) 



TYPES OF LOCKS 



LOCKS WITHIN MULTICS: Vro"X K^U 

ARE 36 BIT WORDS CONTAINING EITHER ZERO (UNLOCKED) OR A 
PROCESS_ID (LOCKED) 

1 CONTROL PROCESSES, NOT PROCESSORS 



ARE MUTUALLY EXCLUSIVE LOCKS 



THE HARDWARE SUPPORTS SEVERAL INDIVISIBLE INSTRUCTIONS USED IN 
IMPLEMENTING THE LOCKING PRIMITIVES. FOR EXAMPLE: 



STAC (STORE A CONDITIONAL) 

IF C(Y)=0 THEN C(A) -> C(Y) 

5 TYPICAL USE: LOCKING = IF THE LOCKWORD (Y) IS UNLOCKED (=0) 
THEN LOCK THE LOCK BY STORING THE PROCESS_iD (WHICH IS IN A) 
INTO THE LOCKWORD 



SPECIAL HARDWARE PROHIBITS SIMILAR REFERENCES BY OTHER 
PROCESSORS DURING THE TEST AND DATA TRANSFER WINDOW 



ALSO STACQ (STORE A CONDITIONAL ON Q) , LDAC (LOAD A AND CLEAR), 
LDQC (LOAD £ AND CLEAR), SZNC (SET Z AND N AND CLEAR) 
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TYPES OF LOCKS 



B WITHIN THE MULTICS SUPERVISOR EXISTS TWO TYPES OF LOCKS; 
LOCKS AND WAIT LOCKS 



LOOP 



LOOP LOCKS 




SIMPLIFIED PL/I ANALOGY: 

do while (lockword ^=0); 

end; 

lockword = process_id; 

<update data> 

lockword = 0; 



LOOP LOCKS ARE USED WHEN IT WOULD NOT BE ACCEPTABLE TO GIVE 
UP THE PROCESSOR BEFORE LOCKING THE LOCK. 



LOOP LOCKS TYPICALLY PROTECT THE LOWEST LEVEL OF CRITICAL 
SUPERVISOR DATABASES: TRAFFIC CONTROL, PAGE CONTROL, ETC. 
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TYPES OF LOCKS 



WAIT LOCKS (SIMPLIFIED) 



B A 




44mi'^H»iit-^ih^ ^ J 



A: PROCESS GIVES UP THE CPU 

B: PROCESS DISPATCHED TO A CPU 



SIMPLIFIED PL/I ANALOG?: 

do while (lockwbrd '^=0); 
<GIVE UP PROCESSOR> 
<WAIT FOR NOTIFICATION> 

end; 

Lockword = process_idr 

rf' T^*^/^ -k ^ a /^ ^ ^ ^ "S 

Lockword = 

<SEND NOTIFICATION> 



MOST SUPERVISOR LOCKS ARE WAIT LOCKS 



IN GENERAL, A PROCESS IS ALLOWED .TO GIVE UP ITS PROCESSOR 
WHEN IT HAS WAIT LOCKS LOCKED 



THE WAIT LOCK MECHANISM WILL BE DESCRIBED IN MORE DETAIL IN 
TOPIC 9 
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B FUNCTION 



NAME/APbRSSS SPACE OVERVIEW 



IMPLEMENT THE PER PROCESS VIRTUAL MEMORY 
s BASIC PHILOSOPHY 



AS A NEWLY LOGGED IN USER ATTEMPTS TO TOUCH VARIOUS SEGMENTS A 
CONSIDERABLE AMOUNT OF MANAGEMENT INFORMATION MUST BE 
(TRANSPARENTLY) FOUND AND /OR COMPUTED BEFORE THE USER'S 
REFERENCE IS ACTUALLY ACCOMPLISHED 



FOR EVERY, SEGMENT REFERENCED BY THE USER, THE SUPERVISOR: 



ASSIGNS A SEGMENT NUMBER (FOR REASON OF HARDWARE ADDRESSING), 
AND 






SOFTWARE EFFICIENCY AND CONTROL) 



SUCH SEGMENTS ARE SAID TO BE "KNOWN TO THE PROCESS" 



THE MANAGEMENT INFORMATION IS MAINTAINED ON A PER PROCESS BASIS 
IN THREE COMPLEMENTING AREAS: DSEG, KST , AND RNT 
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NAME /ADDRESS SPACE OVERVIEW 



MANAGES TWO DISTINCT SETS OF INFORMATION: 



ADDRESS SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND 
THE SEGMENTS THEMSELVES 



I NAME SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND NAMES 
THE USER REFERS TO THEM BY 

CALLS DIRECTORY CONTROL TO LOCATE SEGMENTS INITIALLY 



NAME SPACE / ADDRESS SPACE MANAGEMENT IS INVOKED BY SUBROUTINE 
CALLS, AND BY LINKAGE FAULTS (THE "DYNAMIC LINKER"). 



B PRINCIPAL USER INTERFACES 



5 COMMAND LEVEL 



initiate, terminate, terminate_segno, terminate_ref_nanie, 
terminate_single_ref_name,, list_ref_naine 



THE COMMAND, PROCESSOR ITSELF - WHICH USES THESE SERVICES TO 
LOCATE COMMANDS 



SUBROUTINE LEVEL 



hcs_$initiate, hcs_$initiate_count_, hcs_$terminate_f ile, 
hcs_$terniinate_seg, hcs_$terniinate_naine, 
hcs_$terminate_noname, term_ 
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NAME /ADDRESS SPACE OVERVIEW 

B MAJOR DATA BASES 

DESCRIPTOR SEGMENT (DSEG) - ONE PER PROCESS 

I SEGMENT DESCRIPTOR WORD (SDW) - ONE PER KNOWN SEGMENT 
B DEFINES THE USER'S ADDRESS SPACE TO THE HARDWARE 

B KNOWN SEGMENT TABLE (KST) - ONE PER PROCESS 

I KNOWN SEGMENT TABLE ENTRY (KSTS) - ONE PER KNOWN SEGMENT 
(EXCEPT SUPERVISOR SEGMENTS) 



DEFINES THE USER'S ADDRESS SPACE TO THE SUPERVISOR AND THE 
USER 



EACH KSTE ASSOCIATES A USER'S SEGMENT NUMBER WITH THE SEGMENT 
CONTROL ATTRIBUTES OF THAT SEGMENT 



THE SEARCH FOR AN AVAILABLE KSTE DETERMINES A SEGMENT'S 
NUMBER 



REFERENCE NAME TABLE (RNT) - ONE PER EACH RING IN EACH PROCESS 

NOT A SEGMENT - KEPT AS A REGION ALLOCATED IN THE "LINKAGE 
AREA" FOR EACH RING 

g REFERENCE NAME TABLE ENTRY (RNTE) - ONE PER REFERENCE NAME 

USED BY THE DYNAMIC LINKER TO IMPLEMENT THE 
"initiated secments" SEARCH RULE 



Not To Be Reproduced 4-3 FoOA 



NAME /ADDRESS SPACE OVERVIEW 



I DEFINES THE USER'S NAME SPACE TO THE USER 



NA^!E SPACE MAY BE DIFFERENT IN DIFFERENT RINGS OF THE SAME 
PROCESS 



PXP3 



Ki 1 






^oo 
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NAME /ADDRESS SPACE TERMINOLOGY 



SEGMENT DESCRIPTOR WORD (SDW): 

A TWO WORD PAIR USED BY THE HARDWARE WHEN REFERENCING A 
SEGMENT . 



DESCRIPTOR SEGMENT (DSEG) : 

THE MOST FUNDAMENTALLY IMPORTANT SEGMENT IN A PROCESS. 
CONTAINS AN ARRAY OF SDW'S DEFINING THE ADDRESS SPACE 
OF THE PROCESS 



ADDRESS SPACE: 



THE SET OF ALL SEGMENTS (PROCEDURE AND DATA) FOR WHICH 
THE PROCESS HAS A SEGMENT NUMBER AND A CORRESPONDING 
SDW. THE ADDRESS SPACE EXPANDS AND CONTRACTS DURING' A 
SEGMENT'S LIFE 



SEGMENT NUMBER: 



V-^'^^■^^ 



S>9't V 






n _ 1 IT! 



UNIQUELY TO 
OFFSET INTO 
SEGMENT 



A SEGMENT. 
THE ARRAY 



\ W * W fc -* 



ncrTMar ^ 



accTrrMTm 



USED BY 
OF SDW'S 



THE HARDWARE AS AN 
WHEN REFERENCING A 



MAKING KNOWN: 



THE ACT OF ASSIGNING A SEGMENT NUMBER TO A SEGMENT, 
THEREBY ADDING IT TO THE ADDRESS SPACE. SEGMENTS MUST 
BE MADE KNOWN BEFORE THEY CAN BE REFERENCED 
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NAME SPACE: 

THE SET OF ALL SEGMENTS FOR WHICH THE PROCESS HAS A 
REFERENCE NAME. THE REFERENCE NAME MAY BE DIFFERENT 
THAN THE SEGMENTS ACTUAL NAME (ITS ENTRYNAME) . SINCE 
SOME SEGMENTS IN THE ADDRESS SPACE HAVE NO REFERENCE 
NAME, THE NAME SPACE IS A PROPER SUBSET OF THE ADDRESS 
SPACE 
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NAME /ADDRESS SPACE CONCEPTS 



A MULTICS PROCESS IS A WELL DEFINED COLLECTION OF UNIQUE SEGMENTS, 
EACH WITH DEFINED ACCESS, OVER WHICH A SINGLE EXECUTION POINT IS 
FREE TO ROAM (I.E., FETCH INSTRUCTIONS AND MAKE DATA REFERENCES) 



THE ADDRESS SPACE OF A PROCESS IS THE ABOVE "COLLECTION OF 
SEGMENTS". SUCH SEGMENTS ARE SAID TO 3E KNOWN TO THE PROCESS 



ALL SUPERVISOR (RING 0) SEGMENTS ARE PLACED INTO THE ADDRESS 
SPACE AT PROCESS CREATION TIME. THIS ADDRESS SPACE IS SAID TO 
BE "CLONED" FROM THE INITIALIZER ADDRESS SPACE 

I THE RING ZERO ADDRESS SPACE IN ANY PROCESS IS THE SAME AS THE 
INITIALIZER'S RING ZERO ADDRESS SPACE, EXCEPT FOR THE DSEG , 
KST , PDS , PRDS , AND STACK_0 , 

THE RING ZERO ADDRESS SPACE HAS NO RNT, BECAUSE IT IS SET UP 
DURING SYSTEM INITIALIZATION, AND DOES NOT CHANGE 

^xJ^ ^^Q^ do<'^^''^ d^|KP>r^"c w^k.ACA 6o^ y 

5 OTHER SEGMENTS ARE MADE KNOWN AND, UNKNOWN DURING THE LIFE OF THE 
PROCESS 

D IMPLICITLY BY THE DYNAMIC LINKER (LINKAGE FAULT) OR A SYSTEM 
COMMAND 

print iny_dir>my_seg 

tester 

B EXPLICITLY BY COMMANDS OR SUBROUTINES THAT MANAGE THE ADDRESS 
SPACE 

initiate my_prog call hcs_$terminate_segno 
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NAME /ADDRESS SPACE CONCEPTS 



MAKING A SEGMENT KNOWN IS SIMILAR TO DECLARING A VARIABLE IN A 
PL/I PROGRAM. IT SIGNIFIES INTENT, BUT NOT USAGE 

THE PRESENCE OF ONE OR MORE PAGES OF A SEGMENT IN MAIN MEMORY 
IMPLIES THAT THE SEGMENT IS KNOWN TO {AND IS BEING USED BY) AT 
LEAST ONE USER 



J BEING KNOWN DOES NOT IMPLY PRESENCE IN MAIN MEMORY 



NOTE THAT THIS -SET OF SEGMENTS, THE EXECUTION_ POINT, : AND THE. 
REGISTERS AND INDICATORS OF THE PROCESSOR, UNIQUELY DEFINES THE 
STATE OF THE PROCESS 
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NAME /ADDRESS SPACE CONCEPTS 



NAME SPACE AND ADDRESS SPACE MANIPULATION 



© PROCESS CREATION 



(2) INITIATE WITHOUT 
REFERENCE NAME 



(3) INITIATE WITH 

REFERENCE NAME 




THE mt IS AN AREA WITHIN [pd]> [unique] .areaJinker 
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267 qedx 



272 cwd 



266 pil 



267 qx 



NAME SPACE AND ADDRESS SPACE MANAGEMENT 



RNT 
(USER'S NAME SPACE) 



PER PROCESS 



DATA BASES 





KSTE FOR cwd 



KSTE FOR seg_3 



KSTE FOR qedx 



KSTE FOR pll 



271 



270 



267 



266 



SOW FOR cwd 



SDW FOR seg_3 



SDW FOR qedx 



SDW FOR pll 



KST DSEG 

(USER'S ADDRESS SPACEl 



PER SYSTEM 



DATA BASES 



PT FOR qedx 



PT FOR seg_1 



PT FOR pll 



PT FOR A.pn 



PAGE 4 OF qedx 



PAGE 3 OF pll 



PAGE 41 OF xyz 



PAGE 16 OF pll 



PAGE TABLES* 
(SYSTEM'S ADDRESS SPACEl 



MAIN MEMORY 
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THE ASTES ASSOCIATED WITH THE PAGE TABLES ARE NOT SHOWN IN THIS DIAGRAM 
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MULTICS VIRTUAL MEMORY STRUCTURE 



USER A'i 
ADDRESS SPACE 



USER A's 
VIRTUAL MEMORY 



USER A'i 
SEGMENT TABLE 



I 
I- 



qetlx 



S data 



ioiii mailbox 



fault vector 



dseg 





cwd 






led 






S_data 
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USER B's 
ADDRESS SPACE 
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USER B'l 
VIRTUAL MEMORY 
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REAL MEMORY 



USER B'l 
SEGMENT TABLE 
(ONE ENTRY PER 
KNOWN SEGMENT) 



SYSTEM'S PAGE 
TABLES 

(ONE PER ACTIVE 
SEGMENT) 
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34567S9012 
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1122222222223333 
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3 3 

4 5 


POINTER TO ALLOCATION AREA 


INSERT TRYS 


INSERT WINS 

■ 


GET_SEG_NO TRYS 


GET_SEG_NO_WINS 


GET_RNAMETRYS 


GET_RNAME WINS 


0ELETE_SEG_NO TRYS 


DELETE_SEG_NO WINS 


DELETE_NAME TRYS 


DELETE_NAME WINS 




' 


^ 


RNT AREA SIZE 


SEARCH RULES POINTER 


1 1 . ■ 1 -' 



128 WORDS FOR 
REFERENCE NAME HASH TABLE 



128 WORDS FOR 
SEGMENT NUMBER HASH TABLE 






ID 



NAME FORWARD R PTR (TO SAME HASH) 



SEG NO FORWARD R_PTR (TO SAME HASH) 



SEG NO 



NAME LENGTH (Lj 



L CHARACTERS CONTAINING 
SEGMENTS REFERENCE NAME 




{mt.incl.pM t 



REFERENCE NAME TABLE (RNT) 

A PAGED DATA BASE ( Ipd] » mt) ■ ONE PER ACTIVE PROCESS 
"INITIATED SEGMENTS" IN SEARCH RULES 

REFERENCE NAME TABLE ENTRY (RNTE) 

ONE PER REFERENCE NAME 
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NAME /ADDRESS SPACE DATA BASES 
KNOWN SEGMENT TABLE (KST) 



5 i • 3 3 D 
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LOWEST SEGMENT NUMBER 


1 


■ , 


HIGHEST SEGMENT NUMBER 




J HIGHEST SEGMENT NUMBER YE7 USED 




NUMBER OF PBIVATE LOGICAL VOLUMES 

i 


= 


TIME OF SOOTLOAO 


< 


NO. OF KST GARBAGE COLLECTIONS 


NO. OF KST ENTRIES RECOVERED 




FIRST FREE KSTER.PTR !'■ i' 


RiRiaiBITil V, 









64 WORD ARRAY FOR UIO HASH TABLE 





FORWARD R_FTH 


SEGMENT NUMBER 










NUMBER 1 


OF TIMES THIS 








SEGMENT 


INITIATED (FER HINGl 












BRANCH ENTRY POINTER 
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SEGMENTS UNIQUE IDENTIFIER (UtOI 












DATE TIME BRANCH ENTRY MODIFIED (DTBMI 
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OTHER KSTE'J 
ONE PER INITIATED SEGMENT 



256 WORD LIST OF PRIVATE LOGICAL 
VOLUME CONNECTIONS 



SNO OF KST 



KNOWN SEGMENT lABLE iKSTl 
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ENTRY POINT BOUND 
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(WORDS) 




DESCRIPTOR 15EGMENT (DSEG) 

A PAGED dpd] > dseg) DATA BASE - ONE PER ACTIVE PROCESS 



SEGMENT DESCRIPTOR WORD (SDW) 

ONE PER INITIATED SEGMENT IN PROCESS (MAX 1024) 



(sdw.incl.pt1) 
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NAME/ADDRESS SPACE DATA BASES 
DESCRIPTOR SEGMENT (DSEG) 



SEGMENTS IN THE MULTICS HIERARCHY 



INITIATED WITH 
REFERENCE NAME(S) 



INITIATED WITHOUT - 
REFERENCE NAME 

SUPERVISOR 
SEGMENTS 



t z i 



MUST CONNECT USER 
TO CURRENTLY ACTIVE 
SEGMENT -OR- 
RECONNECT BECAUSE 
OF ACL CHANGE, POOL 
PROMOTION, ETC. 



\ 



O 



<• 



IN USER'S RNT -2: 

• ^ * 

X. 



NOT IN USER'S RNT 






zr 



> < » > ' 



IN USER'S KST 



:!!• NOT IN USER'S KST 



IN USER'S DSEG 



- 3 



lu: 

H- 
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P - 

'1: 

X 



NOT IN USER'S DSEG 



VALIDSDWzS 



:?: FAULTED :5: 



ACTIVE SEGMENTS' 



V 



UNPAGED 
SUPERVISOR 
SEGMENTS — 



SDW 

f U> _ - > 



IN THE AST :|: 
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'■T-" 



NO SDW 



NOT IN THE AST 
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HAS A PAGE 
TABLE 



':^: DOES NOT HAVE A PAGE TABLE M 
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STATES OF SEGMENTS AND PAGES 



Not To 3e Reorcduesd 



•RC^ 



TYPICAL ADDRESS SPACE 



COLLECTION ZERO 



I SEGMENTS WK i CH MUST BE PRESENT TO RUN THE VERY FIRST LOADING 
PROGRAM 



I SEGMENTS WHICH HAVE FIXED ABSOLUTE ADDRESSES TO INTERFACE WITH 
HARDWARE 



I ALL DESCRIBED IN tempi ate_s 1 t_. cds 



[pd]>dseg (ring 0) 

The descriptor segment. The Initializer's dseg 
comes from the system tape and is built during 
system initialization; all others are created by 
process creation. 

1 fault_vector (ring 0, perm-wired) 

Contains the interrupt vector, fault vector, and the 
ITS pairs for SCU and TRA instructions. Located at 
absolute locations 0-577. Used by the CPU hardware. 

2 iom_mailbox (ring 0, perm-wired) 

Mailboxes (communications areas) for up to four 
lOMs. Located at locations 1200-3377 absolute. 
Used by the I OM hardware. 

3 >sl l>conf ig_deck (ring 0, deciduous) 

The online copy of the config deck. This is built 
from the config deck provided by BOS during system 
initialization, but it is not the copy BOS actually 
uses. 

k dn355_rnai ' box , (ring 0) 

Mailboxes (communications areas) for up to eight 
FNPs. Located at absolute locations 3400-6377- 
Used by the FNP hardware. 

5 bos_toehold (ring 0, perm-wired) 

The segment containing the tiny program used to 

switch between Multics and BOS at crash time. 

Located at ansolute locations 1OOO0-11777- 
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6 flagbox (ring 0, perm-wired) 

A region inside the bos_toehold segment (yes, it 
really overlaps the toehold) used to access the 
BOS/Multics communication region. 

7 >sll>slt (ring 0, deciduous) 
10 >sl l>name_table (ring 0, deciauous) 

The two primary databases of system initialization. 
The SLT contains one entry for every supervisor 
segment read from the system boot tape, containing 
all its attributes. The separate name_table is used 
to hold the names, because each segment may have 
several 

This marks the end of Collection Zero. All the rest of the segments in the 
address space are either read from the system tape or found in the online 
system. 
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TYPICAL ADDRESS SPACE 
s COLLECTION ONE 

I FIRST BATCH OF SEGMENTS READ FROM SYSTEM TAPE 

I ALL THE PROGRAMS AND DATABASES NEEDED TO MAKE PAGING RUN 



ALL SEGMENTS WHICH MUST BE "perm-wired" — PERMANENTLY ALLOCATED IN 
LOW MEMORY, WITHOUT PAGE TABLES 



11 lot . ■ • .: . \ ■ ^'■'"9 °^ 

The supervisor's linkage offset table. Used to find 

1 inkage sections. Built as the segments are read in 
from tape. 

12 as_l inkage (ring 0) 

13 ws_l inkage (ring 0) 

The permanent supervisor combined linkage regions. 
The names mean "Active Supervisor Linkage" and 
"Wired Supervisor Linkage", respectively. The 
linkage sections of all permanent supervisor 
segments are put in one of these as the segments are 
read from the tape. 

Ik >sl l>def initions_ (ring 0, deciduous) 

The segment containing all the definitions sections 

of supervisor programs. The definitions sections 

are placed here as the programs are read from the 
tape, and used by the hardcore prel inker. 

15 sst_seg (ring 0, perm-wired) 

The segment containing all ASTEs and page tables. 
Covered in under Page and Segment Control. This 
segment is allocated at the very top end of the 
bootload SCU. 

16 core_map (ring 0, perm-wired) 

All the core map entries, describing all system 
memory. Covered under Page Control. This used to 
be part of the SST, but was moved out to make more 
room for page tables. 

17 abs_seg (ring 0, abs-seg) 

An abs-seg used for complex call-side operations in 
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page control, 
reconf igurat ion. 



such 



as 



evict_page 



and 



20 abs_segl (ring 0, abs-seg) 

An abs-seg used only by page control for checking 
page frame contents for zeros, and zeroing newjy 
allocated page frames. 



21 backup_abs_seg 

An abs-seg used to access the 
in a Volume Dumper process, 
which refers to any ordinary 



(ring 
segment being dumped 
It is given an SOW 
segment. This is a 



0, abs-seg) 



very special hardcore segment, because it has. 
trailer entries, and it is special-cased by the 
trailer manipulation program, setfaults. Normal 
hardcore segments never receive trailers, since they 
are. never actfvated or deactivated. 



22 fim_abs_seg 

An abs-seg used by the FIM to do something 



(ring 0, abs-seg) 



23 isol ts_abs_seg (ring 0, abs-seg) 

An abs-seg used by ISOLTS, which gives it an SDW 

describing the low 64K of the SCU being used for 
ISOLTS testing. 

2k volmap_abs_seg . (ring 0, abs-seg) 

An abs-seg used by page control to access record 
stocks. !t is given the SDW of whichever volume's 
stock i s needed. 



25 bound_active_l 

26 bound_disk_uti V 

27 bound_disk_utl l_wi red 

30 bound_error_active 

31 bound_error_wi red 

32 bound_interceptors 

This is where the FIM lives. 



(r i ng 0) 

(ring 0) 

(ring 0, perm-wi rea) , 

(ring 0) 

(ring 0, perm-wi red) 

(ring 0, perm.-wirsd) 



33 bound_io_wi red 

34 bound_iom_support 

35 bound_page_control 

36 bound_priv_l 

37 >sl l>bound_sss_wi red_ 

This is where pi l_operators_ and a whole 
other miscellaneous subroutines live. It 
in a very special way, because not all 
contents need to be wired. In particular, only 
about half of pi l_operators_ needs to be wired, and 
there is a special hack in make_sdw.pl I which finds 
the definition in the middle of pi l_operators_ which 



(ring 0, perm-wired) 
(ring 0, . perm-wi red) 
(ring 0, perm-wired). 
(ring 0, perm-wired) 
(ring 0, deciduous) 
host of 
is wired 
of its 
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marks the end of the wired portion, and makes an 

ASTt for bound_sss_wi red_ which has all its pages up 

to and including that definition wired, and the rest 
unwi red . 

LO bound_tc_priv (ring 0, perm-wired) 

41 bound_tc_wired (ring 0. perm-wired) 

i»2 bound unencacheable (ring 0. perm-wired) 

i43 dir_seg ('"'"S 0. abs-seg) 
An abs-seg now used only at process termination time 

to loop through the dead process's KST in order to 

flush any trailers it had for active segments. 

hk disk_post_queue_seg (ring 0, perm-wired) 

The segment where the core address queue lives:, see 

core__queue_man.2lm. This is discussed under Page 
Control . ■ 

kS disk_seg (ring 0, perm-wired) 

The segment containing the disk DIM's databases: 
device table, channel table, and I/O queues. 

hG dn355_data (ring 0. perm-wired) 

The segment containing software communications 
regions for the FNPs. This is not where FNP buffers 
are kept, but only the mailboxes that describe the 
buffers, and some control information. 

kl ds_seg (ring 0, abs-seg) 

process's DSEG in order to remove a trailer. 
Covered under Segment Control . 

50 emergency_shutdown (ring 0, perm-wired) 

The procedure segment which starts an ESD. It is a 
separate segment because BOS has to be able to find 
it and transfer to it. 

51 hardc.ore_sct_seg (ringO) 

The segment containing the static condition table 
for ring zero; it's just like the one which is kept 
in an outer ring stack header. The only static 
handlers in ring zero are those used to invoke the 
copy_on_wr i te mechanism. 

52 idle dsegs (ring 0, perm-wired) 

53 idle~p«ises (ring 0, perm-wired) 

Two similar segments: they contain the DSEG and PDS 
segments for all the idle processes, all in a row. 
When an idle process is constructed, the SDWs for 
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its DSEG and PDS are set up to point into the middle 
of one of these segments. 

54 i ni t_processor (ring 0) 

55 in2r_stkO (ring 0) ' 

The stack segment used by the Initializer during 
initialization and shutdown. During normal 
operation, the Initializer participates in ordinary 
ring zero stack sharing. 

56 iobm_data (ring 0, perm-wired) 

The database of iobm.pU, the I/O Buffer Manager. 

57, ioi_abs_seg {ring 0, abs-seg) 

The abs-seg used by ibi_j_interrupt.pl I ' t'o access a 
; user ioi_ buffer at interrupt time, for storing 
status Information. 

60 ioi_data (ring 0, perm-wired) 

The database for ioi_ — describes all 
usei — accessable, or potentially user-accessable 
devices. See the programs in bound_io_active and 
bound_io_wired. 

61 iom_data (ring 0, perm-wired) 

Describes the configuration of the lOMs, and 
software information about lOM channels. Contains 
assignment information, software status queue 
location, and metering cells. 

62 oc_data • • ' (ring 0, perm-wired) 

The database for the ring zero operator's console 
mechanism.. This is used by 'syserr in ring zero, and 
by the Initializer to write on the system console 
(but not message coordinator consoles). 

63 Cpd]>pds (ringO, deciduous) 

The Process Data Segment. This contains all the' 
miscellaneous information that makes a process 
unique to the supervisor, and need not be readily 
accessable to other processes. Most per-process 
variables are referenced symbolically, such as 
pdsSprocess i d , pdsSpage fault data (machine 
conditions for last page fault), etc. 

64 >sll>prds (ring 0, deciduous) 

Like the PDS, but. pei — processor. Contains the same 
sort of miscellaneous information, and is also used 
as the ring zero stack for certain types of faults 
(page faults, connects, and timer runouts) aid all 
interrupts. There is a PROS p&r processor, namec 
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>sn>cpu_A.prds, cpu_B.prds, etc. The PRDS segment 
in ring zero is changed at LDBR time to indicate the 
actual PRDS of the processor that the process is 
going to run on; thus, it's sort of an abs-seg. All 
PRDS 's are wired, but have page tables. 

65 >sll>pvt (ring 0, deciduous) 

The Physical Volume Table. Described unver Volume 
Management and Page Control . 

66 rdisk_seg (ring 0, abs-seg) 

A pfw-type abs-seg (the only one where the PTW ever 
changes). Used only by the program read_disk, which 
does I/O to arbitrary pages on any disk, its 
aste.pvtx and PTW are switched around to indicate 
the rigtit page,- which is , faulted on and (if . needed) . 
written back out by pcScleanup. 

67 restart_fault (ring 0) 
70 return_to_ring_0_ (ring 0) 

These two procedures are used to implement the 
restarting of faults (such as a QUIT signal) from 
the user ring. When a fault occurs, a frame is 
pushed on the user ring stack, with its owner set to 
be return_to_r ing_0_. Additionally, the machine 
condi tions~for the fault are saved in ring zero (in 
the PDS) so that when restart_faul t is called to 
restart a possibly modified set of conditions, it 
can compare and validate. 

/I seas ^' ' "y "' ""^ «»b' 

The System Controller Addressing Segment. This 
segment has a page overlaid on a page of every 
system controller. No data is ever accessed through 
this segment; its page table is not even in the SST, 
but in the SCS. It is used only for certain 
privileged instructions which require an effective 
address in an particular SCU in order to read or set 
control registers in the SCU. 

■J2 SCS (ring 0, perm-wired) 

The System Configuration Segment. It describes most 
of the hardware configuration, and contains various 
control words used by privileged control 
instructions. 

73 signaller (ring 0) 

The procedure which implements user ring fault 
signal 1 i ng. 
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74 >sl l>sst_names_ (ring 0. deciduous) 

The SST name table. This is a debugging feature; it 
contains (when in use) the primary name 
corresponding to every segment in the AST. It can 
be ntaintained online, by use of the PAP.M ASTK config 
card, but usually is not. it is always filled in by 
FDUMP after a crash if it was not already in use. 

75 stack_0_data (ring 0, perm-wired) 

Data segment describing the available segments for 
use in ring zero stacl< sharing. These segments, 
seen later on as segment 230, are recorded here and 
multiplexed among eligible processes. 

76^ stock_seg ' " '■ ■ ' ' ■ (ring 0, perm-wired) 

The segment containing all in-core record and VTOCE 

stocks for use by page control and segment control, 
and covered under those topics. 

77 >sl l>sys_boot_info (ring 0, deciduous) 

A data segment containing information about the I/O 
devices (tape and disk) used during boot load. 

100 >sl l>sys_info (ring 0, deciduous) 

Contains assorted global wired information shared by 
the user ring and supervisor. Some is set during 
boot load, and some comes off the tape; none is 
modified after initialization is complete. 

101 syserr_data (ring 0, perm-wired) 

Data segment for the lowest level of the syserr 
mechanism. Syserr messages are built and queued 
here, and sent to the console. They are also copied 
out by the syserr logger hardcore process, into the 
syserr_log. 

102 syserr_log (ring 0. abs-seg) 

This segment overlays the LOG partition on some 
disk, which is used to reliably store syserr 
messages until they can be copied into the 
perm_syserr_!og maintained in the Hierarchy. 

mi r^ As*^ (r'lnn Q) 

The traffic control data segment; contains all 
traffic control data. Covered under Traffic 
Control . 

lOit wi red_hardcore_data (ring 0, perm-wired) 

Miscellaneous data used by the wired supervisor. 
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e COLLECTION TWO 



I THE UNWIRED PORTION OF THE SUPERVISOR 



READ IN BY COLLECTION ONE, DIRECTLY INTO PAGED 
SEGMENTS IN THE HARDCORE PARTITIONS 



105 >s>l>active_an_rings_data (ringO, deciduous) 

Miscellaneous data shared between the unwired 
supervisor and the outer rings. 

106 active_hardcore_data (ring 0) 

Miscellaneous data used by the unwired portion of 
the supervisor: system-wide locks, size constants 
for directory control, system search rule info, and 
metering for directory control and the dynamic 
linker. 

107 >sll>admin_gate_ (ring 0. deciduous) 
no ast_lock_meter_seg (ring 0) 

A~ segment used to collect AST lock metering, 
normally off (enabled by the ast_lock_meter ing 
tuning parameter). 

111 >sl l>audit_gate_ (ringO. deciduous) 

112 bound_355_wired (ring 0) 

113 bound~f i 1e_system (ring 0) 

114 bound_hc_backup (ring 0) 

115 bound_hc_reconf ig (ring 0) 

116 bound_hc_tuning (ring 0) 

117 bound" imp_dim_ (ring 0) 
mp_status (ring 0) 



120 bound 

121 bound 



122 



_.o_active (ring 0) 

bound~mcs uti 1 (ring 0) 



123 bound'priv.mpx (ring 0) 

I2I4 bound3networkO_ . (ring 0) 

125 bound_priv_procs (r i ng 0) 

126 bound_process_creation (ring 0) 

127 bound~salvager (ring 0) • 

130 bound~scavenger (ring 0) 

131 >sl l>bound_sss_active_ (rIngO, deciduous) 

132 bound_system_faults ~ (ring 0) 

133 bound_tty_active (ring 0) 
bound~vtoc_man (ring 0) 
bound""x25 mpx (ring 0) 



Ilk 

155 
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136 dbm_seg (ring 0) 

The segment used to hold the dumper bit maps for 
volumes being volume-dumped. The bitmaps are read 
from the volume header when a dump begins, and 
written bacic when finished. 



137 dirlockt_seg (ring 0) 

The segment used to keep track of all directory 
locks. Directory locks are kept in a supervisor 
segment, rather than in directories themselves. 



UO >sl l>dm hcs 



141 
142. 



144 
145 
146 
147 
150 
151 
152 
153 
154 



>s n>dm_jour na l_seg_ 
>sl l>error_table_ 

\ ^p_idi»pPi.seg-.: ' ■:. ■•'•■•■ > ■• ".•>■ i^^: '■ ■ '■ "• • "■ • • 

Segment ■ used for data buffering by FNP 

' patch -operationis (but not bootload). '" . 



(ring 0, deciduous) 
(ring 0, deciduous) 
(ring 0, deciduous) 
0) 



.. .(ring 
dump and 



hasp_mpx 

>sl i>hc_backup_ 

>sl l>hcs_ 

>s!l>hphcs_ 

i bm3270_mpx 

imp_data 

!mp_dim_buf_ 

imp_tables 

imp_wired_buf fers 
These four segments were used by 
DIM (part sf the ARPAnet support) 
been decomissioned. 



(ring 0) 
(ring 0, 
(ring 0, 
(ring 0, 
(ring 0) 
(ring 0) 
(ring 0) 
(ring 0) 
(ring 0) 
the ring zero !MP 
which has since 



deciduous) 
deciduous) 
deciduous) 



155 ini tial i2er_abs_seg 

An abs-seg used solely 
stack_0 segment into 
process termination. 



(ring 0, abs-seg) 
in order to copy a process 's 
its process directory on 



156 >si l>ini tial i2er_gate_ 

157 i o_page__tab I es 

The segment which contains page tables .used 
if the lOM is operating in Paged mode. 



(r i ng 0, dec iduous) 
(ring 0) 
for I/O 
It is 



ini tial ized by' ioi_i ni t and used only for ioi_ I/O. 

160 ioat (ring 0) 

The I/O attach table. This is a largely obsolete 
database, the relic of an earlier I/O device 
attachment scheme. It is now used only for loading 
and dumping FNPs. 



161 >sll>ioi_ 
62 Cpd]>kst_seg 



(ring 0, deciduous) 
(rina 0, dsci'^uous) 



Not To Be Reproduced 



4-25 



■80 A 



TYP I CAL ADDRESS SPACE 



166 

167 

170 

171 ■ 

172 

173 



174 

175 

.176 

177 

200 



201 
202 

203 



The Known Segment Table. 
Address Space Management. 



163 Ivt 

The Logical 
Manaoement. 



Volume Table. 



Descri bed 



Described 



Name & 



I n 



(ring 0) 
Vo 1 ume 



l(,k >sll>mhcs_ 

165 ncp_tables_ 

Another part of the now-decommissioned 
ARPAnet support, no longer used. 



(ring 0, deciduous) 
(ring 0) 
rina zero 



>s 1 l>net_r i ngO_adm i n_ 
>s 1 l>net_r i ngO_sys_ 
>s 1 l>net_r i ngO_user_ 

■>sil>phcs_- ■ •:. ^ .-:■,-. — '..."•: , ;:' 

po 1 1 ed_v i p_mpx 

pv_salv_seg '■ 

This data segment is created in order 

physical volume salvager (now rarely 

contains various databases used by the salvager. It 

is created (by calling grab_aste.pl 1) and destroyed 

for each volume salvage, in each process running a 

salvage, rather than being a shared segment. 



(ring 0, deciduous) 
(ring 0, deciduous) 
(ring 0, deciduous) 
^ (ring 0, deciduous) 
(ring 0) 
(ring 0) 

to run the 

used) . It 



sa 1 v_abs_seg_00 
salv_abs_seg_01 
sa 1 v_aDS_seg_02 
sa 1 v_abs_seg_03 

salv_abs_seg_0i4 



(ring 0, abs-seg) 

(ring 0, abs-seg) 

(ring 0, abs-seg) 

(ring 0, abs-seg) 

(ring 0, abs-seg) 



These five segments are used to overlay the VTOC of 
a volume being salvaged, arid are set up and 
referenced by vm_vio.pll. Covered under File System 
Salvagers. 



salv_di r_space 

salv_data 

salv_temp_di r 

These three segments are used by 
salvager when invoked as the online 



(ring 0) 
(ring 0) 
(r i ng 0) 
the directory 
salvager, in 
response to a crawl out or bad_dir_ condition. Only 
one instance of the online salvager may be running 
at a time, and this is ensured by a lock on 
salv_data. The online salvager does not interfere 
with demand directory salvages, however. Covered 
under File System Salvagers. 

20ii scavenger_data (ring 0) 

The segment containing the tables used when running 
the online volui^e scavenger. As many volumes as 
tables can be fit nere may be scavenged at one time. 
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The in-use portion of the segment is wired while a 
scavenge is being done. Covered under File System 
Salvagers. 

205 >sll>shcs_ (ring 0, deciduous) 

206 str_seg (ring 0) 

The segment trailer segment. The trailers in this 
segment record which processes have an SOW for any 
particular non-supervisor segment, and the 
bacl<up_abs_seg (see above) . Covered under Segment 
Control . 



207 syserr_daemon_dseg 

210 sy,serr_daemon_pds 

2 1 1 . sy s e r r_<iaemoh_s tack 

The. DSEG, POS, and ring 
■ ■' logging daemon, 
processs (which 
created. They 
space primarily 
purposes. 



(ring 0) 
(ring 0) 

..(ring 0) 

syserr 

daemon 



zero stacic of the 
They are fillisd'. in wherr the 

runs entirely in rfng zero) is 
are in the global system address 

for debugging and recordkeeping 



212 >sl l>system_privi ]ege_ (ring 0, deciduous) 

213 >sll>tandd_ (ring 0, deciduous) 

214 template_pds (ring 0) 

A template for the POS, used when creating a 

process. it is a copy of the pds template which 

came off the system tape, but which was used to 
create the initializer's PDS. 

215 tty_are3 (ring 0) 

An unwired database used by ring zero communications 
system, used primarily for saved metering 
information on each channel. 

216 tty_buf (ring 0) 

The important segment in the ring zero 
communications system. Contains the logical channel 
table, all communications I/O buffers, and all 
multiplexer databases. 

217 tty_tables (ring 0) 

An unwired database used by ring zero communications 
system to keep the tables used for input and output 
translation/conversion. 

220 vtoc_buf fer_seg (ring 0) 

The segment containing all buffers for VTOC I/O, and 

a small amount of control information. Covered 
under Segment Control . 
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221 «unused» 

222 «unused» 

223 «unuseci» 
221t «unused» 

225 «unused» 

226 «unused» 

227 «unused» 

These segments are unused, since the first segment 
after the supervisor address space is the ring zero 
stack, and its segment number must be zero mod 8. 

230 >sl l>stack_0.016 (""'"S 0, deciduous) 

The ring zero stack. One is allocated from a pool 
{>sl l>stack_O.NNN) whenever a process becomes 
eligible. When a process is not eligible (blocked, 
usually), it has no ring zero context, and needs no 
ring zero stack. 

231 [pd3>stack 1 

232 «not used» 
232 «not used» 
.231* [pd]>stack_I» 

The rest of the stacks. There would be others if 
other rings were being used. A stack is created for 
each ring as it is needed; the segment number is 
automatically generated by the CALL6 instruction 
(from DBR. stack) , and when a segment fault occurs on 
a stack not yet extant (pdsSstacks (r i ng) is null), 
seg_fault.pl 1 calls makestack .pi 1 to create one. 
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s NON-SUPERVISOR SEGMENTS 



I REMAINDER OF A PROCESS ADDRESS SPACE. 



BUILT BY THE NORMAL NAME AND ADDRESS SPACE MANAGEMENT 
MECHANISMS AS THE PROCESS GETS GOING AND RUNS 



DIFFERENT 


IN DIFFERENT PROCESSES; THIS IS 


ONLY AN 


EXAMPLE 


■c^c^- y^olt'/^^^.^i'''^'^:M,_, 




-:,^W 





2i+0 > (the ROOT) 

The ROOT directory. The recursive nature of the 
initiate/segment fault mechanism ensures that this 
will be the first non-supervisor segment in the 
address space. 



(di rectory) 



241 


>pdd 




242 


>pdd 




243 


>sss>faound_process_i ni t_ 




244 


>udd 




245 


>udd>MED 




246 


>udd>MED>Sibert 




247 


Cpd]>!B8BMj2Kmkcngb.area. 1 


inker 


250 


>sss 




251 


>unb 




252 


>sl 1 




253 


>tools 




254 


>am 




255 


>sl l>bound_sss_active_ 




256 


>sl l>operator_pointers_ 




257 


>s I l>bound_sss_wi red_ 




260 


>sl l>bound_process_env_ 




261 


>sl l>hcs_ ~ ■" 




262 


[pd]>pit~ 




263 


>sl I>bound_error_handlers_ 




264 


>sl l>bound_ipc_ 




265 


>sss>bound_as_requests_ 




266 


>sss>bound_i nfo_rtns_ 




267 


>scl 




270 


>scl>whotab 




271 


>scl i nstal 1st ion_parms 




272 


>sl l>sys_info 




273 


>sss>bound_comm3nd_l oop_ 





(di rectory) 
(di rectory) 
(directory) 

(di rectory) 
(di rectory) 
(di rectory) 
(di rectory) 
(di rectory) 



(d i rectory) 
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27i+ >scl>cornFnand_usage_counts 

275 >5c l>command_usage_counts>command_usage_l i st_ 

276 >scl>command_us3ge_counts>coFnmand_usage_total s_ 

277 >sss>bound_exec_com_ 
300 >sl l>error_table_ 
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system ] ink meters 



a SYSTEM_LINK_H£TERS - RECORDS CPU TIME AND PAGING INFORMATION USED BY THE 
DYNAMIC LINKER IN ALL PROCESSES 



Linkage Meters: 
CPU Meter ing time 



Total time in 1 i nker 
Average time per link 
Percentage of real time in linker 
Percentage of CPU time in linker 



Time slot (msec) . 

'■CkYfs;^v---" -■■'■:-■-• •;:-^'^V'''." : 
Total time in slot 
Percent total time 
Percent total cal Is 
Average time 
Average page faults 

Segment Search 
Average time 
Average page faults 
Percent time in slot 

Get Linkage 
Average time 
Average page faults 
Percent time in slot 

Definition Search 
Average time 
Average page faults 
Percent time in slot 



<25 



.4:58:57 

0:50:53 
6.01 msec. 
17.03 

25-50 



50-75 



>7f 



' -498^*69 " 
0:42:03 
82.63 
98.06 

■ 5.06 
0.18 


" •■•■■'.8357'- :"■ 

0:04:16 

8.40 

1.64 

30.68 

2.29 


, ^--■ .■■.414'- .-- 

0:00:24 

0.81 . 

0.08 

59-63 

6.34 


0:04:09 

8.16 

0.22 

226.53 

5.65 


2.58 

0.04 

57.06 


25.13 

0.95 

82.58 


53.15 

3.53 

86.46 


8.70 
0.22 
3.80 


0.84 

0.06 
18-54 


4.08 

0.62 

13.41 


7.16 

0.93 

11.64 


•219.16 

5.33 

95.71 


0.24 
0.02 
5.26 


0.24 
0.11 
0.80 


0.23 
0.24 
0.37 


0.20 
0.00 
C.09 
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1 i nk meters 



s LINK KETERS - RECORDS CPU TIME AND PAGING INFORMATION USED BY THE 
DYNAMIC LINKER IN THE PROCESS RUNNING IT 



Linkage Meters: ^lr _SV)es^\^'^'^ 

slot calls avg time avg pf tot time % time 



<25 


121,5 


k.dSS 


0.3 


5.838 


76.1 


25-50 


34 


30.201 


2.9 


1.027 


13. i* 


50-75 


6 


62.226 


6.2 


0.373 


4.9 


>75 


2 


216.5^*5 


6.0 


O.i.33 


5.6 



Total 1287 5-961 Q.k 7-671 
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display kst entry 



OiSPLAY_KST_ENTRY - DISPLAYS iNFORMATlON FROM A KST plcf 



I display_kst_entry >udd>Mul tics>Sibert 




segno: 246 at 162 | 270 

usage: 7;0 _^p, 0. 0, 0, 0, 

entryp: (Ik^^lQTSO 
u i d : 

dtbm: 446556324757 

rmede:-.- v '7^ (O.-.Oi. 0)-^— ^-J^^"^- = - 

ex modet 70000000000 (7 , 7 . l>-S:pA 
ihfeouht':- 3 .:•. ■' , " ' .\ '•" 

hSr.r'. ■ ' ii'"' ■■ ■ - ' '■-■ '-'"- '"'■". ''•'''•■ '-"■ 

flags: dirsw write tms 
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Directory Control 
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DIRECTORY CONTROL OVERVIEW 



B FUNCTION 



8 DIRECTORY CONTROL IS A SET OF HARDCORE MODULES RESPONSIBLE FOR 
THE MAINTENANCE OF THE MULTICS DIRECTORY STRUCTURE — IE: THE 
HIERARCHY 



B ITS TASKS INCLUDE CREATING, MANIPULATING AND INTERPRETING THE 
CONTENTS OF DIRECTORY SEGMENTS, TO INCLUDE: 

f": ACCESS"' CONTROL LISTS '( ACL ' S ), NAMES , 'AND VTOCE POINTERS OF 
...ENTRIES DESCRIBED THEREIN.. 



ONLY DIRECTORY CONTROL IS ALLOWED TO ALTER .THE CONTENTS OF 
DIRECTORY SEGMENTS 



DIRECTORY CONTROL IMPLICITLY RELIES UPON THE SERVICES OF OTHER 
SUBSYSTEMS SUCH AS SEGMENT CONTROL AND PAGE CONTROL, AND ALSO 
INVOKES THEM DIRECTLY BY SUBROUTINE CALL 



DIRECTORIES ARE SIMPLY SEGMENTS TO THESE SUBSYSTEMS 



DIRECTORY CONTROL IS INVOKED ONLY BY SUBROUTINE CALLS 



B PRINCIPAL USER INTERFACES 



I COMMAND LEVEL 
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create, create_dir, link, set_acl, delete_acl, status, list, 
add name , rename 



8 SUBROUTINE LEVEL 

B hcs_$append_branch, hcs_$add_acl_entries, hcs_$append_link, 
hcs_$delete_acl_entries, hcs_$status_, hcs_$chnaine_f ile 



B MAJOR DATA BASES 



DIRECTORY SEGMENTS 



B CONTAIN THE ATTRIBUTES AND OTHER INFORMATION ABOUT THEIR 
SEGMENTS (NEEDED TO FIND SEGMENTS, RETURN STATUS INFORMATION, 
AND BUILD VTOCE'S AT SEGMENT CREATION) 



SEGMENT WHERE DIRECTORY LOCKING IS MANAGED 
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DIRECTORY CONTROL TERMINOLOGY 



Q]r Sp^ ^'^''^ 



d^oh 



■ & 






seg_1 


S 


t u d e n t 
Prince 


_ ■> 

hw_dir 








\ . 


add.pll 




ATI'S 




ATI'S 




ATI'S 




AIT'S 






/ 




/ 




\ 




\ 






hw dir 
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UNIQUE ID (UID)l 36-BIT ID (SERIAL NUMBER) ASSIGNED TO EVERY SEGMENT 
WHEN CREATED 



SON: 



OF A DIRECTORY. AN IMMEDIATELY INFERIOR (SUBORDINATE) 
SEGMENT 



SON'S LVID! 



OF A DIRECTORY,- THE ID OF THE LOGICAL VOLUME ON WHICH 
THE DIRECTORY'S SONS RESIDE (AND WILL RESIDE) 



GRANDSON ; 



OF A DIRECTORY. A SEGMENT INFERIOR BY MORE THAN ONE 
HIERARCHICAL LEVEL 



PARENT: Of A btilaMiWi'. itiE^ ^,uin i Ai« aixvj ijxntn..iwi\i ju«ru-.iii 



ANCESTOR: 



OF A SEGMENT. THE PARENT, OR GRANDPARENT, OR GREAT 
GRANDPARENT, ETC. 



BROTHER: OF A SEGMENT. ANOTHER SEGMENT HAVING THE SAME PARENT 
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BRANCH (1): IN A DIRECTORY. A DATA STRUCTURE, CONTAINED IN A 
DIRECTORY SEGMENT, THAT DESCRIBES AN IMMEDIATELY 
INFERIOR SEGMENT OR DIRECTORY (BUT NOT A. LINK) 



BRANCH (2) 



OF A DIRECTORY. REFERS TO THE ACTUAL SEGMENT OR 
DIRECTORY IMMEDIATELY INFERIOR TO THE DIRECTORY 



ENTRY {!).:. IN A DIRECTORY. SAME AS BRANCH (1) BUT INCLUDES LINKS 



ENTRY (2): OF A DIRECTORY. SAME AS BRANCH (2) BUT INCLUDES LINKS 




RST 



XYZ 



SEGMENT 



DIRECTORY 



LINK 



^^^^^^m A FILE m^^^^^m 



FILE 



.■■.■-.....■.■■J.^-.J.»^JJ.^^^J.-^.T^^-.T^.^^^^-^^V^.^ 



«»» VtTiYMr i iiTi i T l TftTll>TltTll l Tu i 



BRANCH 



^ BRANCH...! 



ENTRY 



STORAGE SYSTEM TERMINOLOGY 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY SEGMENTS 




DIRECTORY SEGMENT STRUCTURE 
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DIRECTORY CONTROL DATA BASES 



DIRECTORY SEGMENTS 



B DIRECTORY SEGMENTS ARE DISK RESIDENT (RLV) DATA BASES MAINTAINED BY 
DIRECTORY CONTROL 



i ONE DIRECTORY SEGMENT PER DIRECTORY IN THE HIERARCHY 



B DIRECTORY SEGMENTS CONTAIN A CATALOG OF STORAGE SYSTEM INFORMATION 
• "ABOUT^OTHER SEGMENTS, DIRECTORIES AND LINKS ' 



a ALL- DIRECTORY' SEGMENTS, BY CONVENTION, RESIDE ON THE ROOT LOGICAL 
VOLUME (RLV) 



B DIRECTORY SEGMENTS ARE CREATED BY append MUCH LIKE NORMAL SEGMENTS 
. ARE CREATED 



a DIRECTORY SEGMENTS CONTAIN MANY INTSR-RELATED COMPLEX DATA 
STRUCTURES TO INCLUDE THE FOLLOWING (NOT NECESSARILY CONTIGUOUS) 
REGIONS: 



I DIRECTORY HEADER 

CONTAINS SELF DESCRIPTIVE INFORMATION LIKE UID, AIM 
CLASSIFICATION, ETC; AND POINTERS TO OTHER REGIONS 
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DIRECTORY CONTROL DATA BASES 



DIRECTORY SEGMENTS 



HASH TABLE 

I USED TO QUICKLY LOCATE AN ENTRY, GIVEN ITS NAME 

1 ENTRY LIST 

I CONTAINS ONE DESCRIPTIVE DATA STRUCTURE (AN ENTRY) FOR EACH 
SEGMENT, DIRECTORY, OR LINK IMMEDIATELY INFERIOR TO THE 
DIRECTORY (I.E. ALL ENTRIES) 

D PERSON_ID AND PROJECT_ID NAME LISTS 

1 CONTAINS ALL PERSON ID' S/PROJECT_ID' S REQUIREtD TO DESCRIBE 
THE ACL, THE AUTHOR, ~ETC. OF ALL SEGMENTS AND DIRECTORIES 
IMMEDIATELY INFERIOR TO THE DIRECTORY (I.E. ALL BRANCHES) 



J NAME LIST (ONE PER ENTRY) 

1 CONTAINS ALL NAMES CURRENTLY ASSIGNED TO THE ENTRY 

PRIMARY NAME IS ACTUALLY CONTAINED IN ENTRY STRUCTURE 
ITSELF 



ACCESS CONTROL LIST (ONE PER ENTRY) 

fl CONTAINS ALL ACL ENTRIES CURRENTLY ASSOCIATED WITH THE ENTRY 
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X^\oc}{X_bc^ h-v^e^ipr .Vw.^:lPr \0c^,^ c,^r^/^ 



7^0 Pxo R J 



"u7o_ -pTJ ; ^T 



DIRECTOR? CONTROL DATA BASES 



DIRECTORY HEADER 



8 

3 
10 
11 

' 12 
13 

14 
IS 
16 
17 
18 
19 
20 



' "1 : J 1 1 1 1 1 
012345673901231567 


112222222222333333 

890I2313S7593123-IS 


PROCESS 10 OF-i.ASMIQ£UaER C'JCU^ rAsi'^^t*^ 


TYPE OF OBJECT <OIR H6A06B • 31 


SIZE OF HEADER (64 WORDS 





6 WORDS USED SY SALVAGER FOR RECORDING 
DATE TIME CHECKED AND ERRORS DISCOVERED 

— U L 



OmECTORV*SUNU»JE IDEMTIFIER lUlOl 



OIRECTORVS PHYSICAL VOLUME ID (PVIOI 



SONS' LOGICAL VOLUME ID (LVIOI 



ACCESS ISOLATION MECHANISM IAIM> CLASS 



OIRECTORySVTOCX 



HEADER VERSION NUMBER 



ENTRY LIST START R_FTH 



ENTRY UST END R_PTH 



PERSONJO LIST START H_PTR 



PROJECTED LIST START H JTR 



PERSON.I0 UST END R_PTR 



MUM8ER OF SEC ENTRIES 



PROJECT 10 LIST END R PTR 



nuMBEfi OF QIR ENTRIES 



NUMBER OF UNK ENTRIES 



NUMBER OF ACL ENTRIES 



ALLOCATION AREA R PTR 



E 10 
R I 



- I _ u" 'V V ■■■ 



y* ^^^ sy^ ^ ^ ^ *y jy '^ 



24 WORDS USED FOR INITIAL ACL IMPLEMENTATION 



4S 



49 



63 



HASH TABLE SIZE 


HASH TABLE R_PTR 


NUMBER OF USED PLACES IN HASH TABLE 1 " ^'f S ^ ' h\' ' "•/ ~^ '\'.. '- ' ' , 


DEPTH OF THIS DIRECTORY \ tjj^ '-'>"'' I -=■ .-i ,'>''*- ' ~ j J % 




. 


DATE TIME SALVAGED (OTSI 


UiO OF SUPERIOR MASTER OIR 


MODIFICATION PSEU0O«L0CK 










CHECKSUM (NOT USEOI 



UID OF PARENT DIR 



IWOROS) 



DIRECTORY HEADER 



A OISX RESIDENT (RLV - DIRECTORY SEGMENT) DATA BASE - ONE PER DIRECTORY 
<NOT WIRED. NOT ENCACHEABLEl 
■COPIED FROM BRANCH WHEN CREATED 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY HEADER 



THE DIRECTORY HEADER IS A DISK RESIDENT DATA BASE CONTAINED AT THE 
BEGINNING OF A DIRECTORY SEGMENT 



ONE DIRECTORY HEADER PER DIRECTORY SEGMENT 



B THE DIRECTORY, HEADER CONTAINS SELF DESCRIPTIVE INFORMATION SUCH AS; 



the" PROCESS "id OF THE ' LAST PROCESS TO MODIFY THE DIRECTORY 
SEGMENT'S CONTENTS 



I THE DIRECTORY'S UID, LVID, PVID, VTOC INDEX, AND AIM 
CLASSIFICATION 



RELATIVE POINTERS TO THE BEGINNING AND END OF THE ENTRY LIST, 
DTTTscriM in T.TCT PPn.TP.PT Tn T.I ST- AND THE HASH TABLE 



D HIERARCHY DEPTH OF THE DIRECTORY SEGMENT 

I UID OF THE MASTER DIRECTORY AND THE PARENT DIRECTORY 



SON'S LVID - THE ID OF THE LV ON WHICH INFERIOR NON-DIRECTORY 
SEGMENTS RESIDE (AND WILL RESIDE) 



B THE DIRECTORY HEADER IS ACCESSED AT THE BEGINNING OF DIRECTORY 
QUERY AND UPDATE OPERATIONS 
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aoTi 



DIRECTORY CONTROL . DATA BASES 
DIRECTORY ENTRIES 






i/s 



\j^ 






11111111112222JJS2J23353J3 
OlJ3*S«7«»0123«5S7>J0123*S87t90I23i5 



ram«A8D HPTK 



SACXWAROR PTR 



TYP6 0FENTBY iSEG-71 



SIZEOFEMTRV (37VVOROSI 



ENTRrS UNIQUE IDENTIFIER iUiOl 



DATE TIME ENTRY MOOIFIEO (OTEM) 



■^^p"T^ 






NAME UST START H_PTR 



AUTHORS P6RS0NJ0 R_PTR 



NUMBER OF NAMES 



NAME UST ENO R_FTR 



AUTHOirS FRajECT_IO R_TB 



AUTHOR'S TAG 



_Li: 



i n •■ ^ "■•^ ■ '"^ ^'^ rt.....f. [[ 



MHOflOSCt3NTAmiN6 MIMARV NAME 



23 
2« 
IS 
26 
27 
28 
29 
20 
31 
22 
33 
3« 
35 











-* 








DATE TIME DUMPED (OTOI 




' 


SRANCH-S PHYSICAL VOLUME 10 IPVIDI 


SRAiWK-S.-TOCiNBCX 


ST"" 


\ 


0<iiulu!oN|o>^ ., j ENTRY POINT BOUND 




ACCESS ISOLATION MECHANISM (AIM) CLASS 


1 ^ 

Sill j Ria R<3i 


XRdl 


XRI2) XR(3) 


ACL ENTRY COUNT 


ACL START R_PTR 


ACL END R_PTR 


aC AUTHOH-S PERSON_IO R_?TR 


aC AUTHOR-S PROJECT.IO R.PTR 


aC AUTHOR-STAG f^-' 


BIT COUNT tIF OIR. * IMPLIES MSF) 


SONS- INON-OIR-SI LOGICAL VOLUME 10 (LVIO) 




^ 


CHECKSUM FROM OTD 




UIO OF PARENT DIRECTORY 





tm>ROS) 



BRANCH ENTRY 

A DISK RESIDENT IRLV - DIRECTORY SEGMEMTl DATA BASE - ONE PER BRANCH IN DIRECTORY 
'NOT WIRED. NOT ENCACHEASLE) 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY ENTRIES 



S 1 2 3 



,,,,11111122:22222223:3233 
58769012345678901234! 6 7 8 9 .23-5 



FORWARD R PTB 



BACKWARD R_PTB 



TYP€ OF ENTRY ILINK • SI 



SIZE OF ENTRY ira WORDS! 



UNK-S UNIQUE rOENTIFIER (UIDI (NEVER VISIBI.E TO USERS) 



DATE TIME ENTRY MODIFIED (DTEM) 









. ',*-»- 



-r 



NUMBER OF NAMES 



NAME LIST START R_PTR 



NAME LIST END R_FTR 



AUTHOR'S reRSON_IO R_FTR 



AUTHOR'S FROJECT_IO R.FTR 




M WORDS CONTAINING FRIMARV NAME 



DATE TIME DUMPED iOTDI 



PATHNAME SIZE 



42 WORDS CONTAINING THE ABSOLUTE 
PATHNAME OF THE LINK'S TARGET 



S7 
68 



UID CHECKSUM 



UIO OF PARENT DIRECTORY 



IWOROSI 



Idir.link-incl.pJIl 



LINK ENTRY 

A DISK RESIDENT IRLV-DIRECTORY SEGMENTl DATA BASE - ONE PER LINK IN DIRECTORY 
(NOT WIRED. NOT ENCACHEABLE) 
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DIRECTORY CONTROL DATA BASES 



DIRECTORY ENTRIES 



B THE DIRECTORY ENTRY IS A DISK RESIDENT (RLV) DATA BASE CONTAINED 
WITHIN A DIRECTORY SEGMENT 



I ONE DIRECTORY ENTRY (IN THE DIRECTORY SEGMENT) FOR EACH 
IMMEDIATELY INFERIOR ENTRY IN THE HIERARCHY 



a EACH DIRECTORY ENTRY is; A DATA STRUCTURE DESCRIBING THE ATTRIBUTES 
..OF A SEGMENT, DIRECTORY OR -LINK .,.. . 



a DIRECTORY ENTRIES COME IN TWO FLAVORS: 



g LINK ENTRY, (38 OR 72 WORDS) CONTAINING: 

B DATE TIME MODIFIED AND DUMPED (BY THE HIERARCHY DUMPER, NOT 
VOLUME DUMPER) 

RELATIVE POINTERS TO THE ENTRY'S NAME LIST AND AUTHOR'S USER 
ID 



i ABSOLUTE PATHNAME OF THE LINK'S TARGET 
I UID OF PARENT DIRECTORY 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY ENTRIES 



I BRANCH ENTRY, (38 WORDS) CONTAINING: 

DATE TIME MODIFIED AND DUMPED (BY THE HIERARCHY DUMPER, NOT 
VOLUME DUMPER) 

1 RELATIVE POINTERS TO THE ENTRY'S NAME LIST AND AUTHOR'S USER 
ID 

I BRANCH'S UID, PVID, AND VTOC INDEX 

. AIM CLASSIFICATION, ENTRY POINT BOUND, RING BRACKETS, AND 
. RELATIVE POINTERS TO THE ACL 

BRANCH'S BIT COUNT AND BIT COUNT AUTHOR 

SON'S LVID (IF A DIRECTORY) AND PARENT'S UID 

FLAGS DESCRIBING VARIOUS STATES AND PROPERTIES OF THE ENTRY 
SUCH AS: DIRECTORY, MASTER DIRECTORY, SECURITY OUT OF 
SERVICE. COPY AND SAFETY SWITCH, ETC 
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DIRECTORY CONTROL COMMANDS 
di splay branch 

B DISPLAY BRANCH - DISPLAYS BRANCHES IN THE DIRECTORY HIERARCHY 



\ 



I OFTEN USEFUL ON CONJUNCTION WltH DUMP_VTOCE O'^Ca C<:>^^<^^1 

! display_branch >udd>rtul tics>Sibert 

Branch for Slbert In >udd>Mul tics at 2^5120742 




UIO i02j» II 70050. . is vtocx 63 on root4 (of log vol. root) 

Sibert is a directory. ^ 

Ring brackets (0 0) 

Entry modified 02/23/83 1912.1 est Wed 

Dumped 03/20/83 O955.6 est Sun 

5 names . 



DISPLAY IS NOT COMPLETE, SO A R I NG_ZERO_OUMP OF THE SAME DATA IS 
INCLUDED 



^ 



W6't(fV> 



U.^ '^-'' c.- twl^t 



! r i ng_2ero_dump >udd>Multics 20742 46 -ch 



*6\1 



020742 O213IOO2O6O4 000004000Q46 U0240 1 170050 446556324757 SB.x( 

020746 400000000011 020752021152 001720000532 172000000000 j 2... 

020752 021010000000 000006000016 020742000233 000000000000 .... 

020756 1231511.42145 162164040040 O4OO4OO4OO4O O4OO4OO4OO4O Sibert 

020762 040040040040 040040040040 040040040040 040040040040 

020766 000000000000 102401170050 446752147026 000000000000 B.x(..g 

020772 135240026001 000063000000 4OOOOOOOOOOO 000000000000 ] 3 

020776 000000000000 000770000012 021170021300 001720000532 X 

02 1002 172000000000 225072707470 000000000000 000000000000 z : 

021006 033023254650 000000000000 
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VOLUME MANAGEMENT OVERVIEW 



S FUNCTION 



I VOLUME MANAGEMENT IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
AND LOGICAL VOLUMES 



I ITS TASKS INCLUDE: 

I ACCEPTANCE AND DEMOUNTING OF PHYSICAL VOLUMES 

I . " MAINTAINING THE.. ASSOCIATION .BETWEEN PHYSICAL VOLUMES, LOGICAL, 
"VOLUMES, AND DISK DRIVES ' •' -■'::•■■- ....-,•. . . . . . 

8: ENSURING THE INTEGRITY OF VOLUME CONTENTS 

I MAKING VOLUME CONTENTS ACCES SABLE TO PAGE CONTROL (PAGES) AND 
SEGMENT CONTROL (VTOC ENTRIES) 

VOLUME MANAGEMENT IS INVOKED ONLY BY SUBROUTINE CALLS 



Not To Be Reproduced 6-1 F80A 



VOLUME MANAGEMENT OVERVIEW 



s MAJOR DATA BASES 



PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 

PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE KNOWN 
TO THE SYSTEM 

D EACH PVTE IDENTIFIES A DRIVE'S DEVICE NUMBER, SUBSYSTEM NAME, 
DEVICE TYPE, AND INFORMATION ABOUT THE PHYSICAL VOLUME 
CURRENTLY MOUNTED 

0~ USED TO MAP INFERENCES TO' PAGES OF SEGMENTS INTO AN I/O 
REQUEST TO THE CORRECT DISK DRIVE 



g LOGICAL VOLUME TABLE (LVT) - ONE PER SYSTEM 

I LOGICAL VOLUME TABLE ENTRY (LVTE) - ONE PER MOUNTED LOGICAL 
VOLUME 

■ T^i /n«T ^ TTf»iT" /%(->»T»n'« T»Tf mtjei Tr\f^rr'f,r ^rrsr TTUtc TVs BOTXTTTTBC Trv MTPMTIPO 

PVTE'S, AIM CLASS LIMITS, ETC. 

USED TO DETERMINE A USER'S ACCESS TO A LOGICAL VOLUME 
(PRIVATE OR PUBLIC) AND TO LOCATE MEMBER PHYSICAL VOLUMES 



VOLUME HEADER - ONE PER PACK 

VOLUME LABEL (REGISTRATION AND ACCEPTANCE INFORMATION) 

1 VOLUME MAP (OCCUPIED /VACANT INFORMATION FOR VOLUME CONTENTS) 
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VOLUME MANAGEMENT OVERVIEW 



i RECORD STOCKS - ONE PER MOUNTED VOLUME 

I ONLINE CACHE OF INFORMATION ABOUT USED / UNUSED RECORDS ON 
THE VOLUME 



I THIS INFORMATION IS DERIVED FROM . THE VOLUME MAP, BUT KEPT 
ONLINE TO AVOID THE NECESSITY OF REFERRING TO THE VOLUME MAP 
ON DISK EVERY TIME A RECORD IS ALLOCATED OR FREED 



1 WHEN THE CACHE BECOMES COMPLETELY EMPTY OR COMPLETELY FULL, 
... IT MOST BE UPDATED FROM^O DISK - A PROTOCOL ENSURES THAT THE 
COPY ON DISK IS ALWAYS CONSISTENT 



I PROVIDED BY VOLUME MANAGEMENT, BUT USED BY PAGE CONTROL 



VTOCE STOCKS - ONE PER VOLUME 

USED / UNUSED VTOC ENTRIES ON THE VOLUME 
PROVIDED BY VOLUME MANAGEMENT, BUT USED BY SEGMENT CONTROL 



PHYSICAL VOLUME HOLD TABLE (PVHT) - ONE PER SYSTEM 



I RECORDS THE COMMENCEMENT OF COMPOUND I/O OPERATIONS UPON A 
PHYSICAL VOLUME 



THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE 
SUCH AN OPERATION IS IN PROGRESS 
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THE NEW STORAGE SYSTEM 



tjj ,„.»— 



PVrpw 



LOGICAL VOLUME A 



PV root 2 



r 



PV root 3 



HEADER 



VTOC 



PAGING 
REGION 



PARTITION 




LOW PARTITION 



HIGH PARTITION 



LOGICAL VOLUME B 
PVpub01 PVpub02 



HEADER 
VTOC 

PAGING 
REGION 



yK 



HEADER 



VTOC 



PAGING 
REGION 



PHYSICAL VOLUME (PV>: 
LOGICAL VOLUME (LV»: 

VOLUME HEADER: 

VOLUME TABLE OF CONTENTS (VTOC) 

PAGING REGION: 

PARTITION: 



A DISK PACK 

A COLLECTION OF ONE OR MORE PHYSICAL 
VOLUMES GIVEN A SINGLE LOGICAL IDENTITY 

CONTAINS THE LABEL. VOLUME MAP. VTOC 
MAP. AND VOLUME DUMP MAPS. 

AN ARRAY OF ENTRIES (VTOCE's) DESCRIBING 
EACH SEGMENT ON THE PHYSICAL VOLUME 

THE REGION IN WHICH ALL RECORDS DESCRIBED 
IN THE VTOC RESIDE (I.E.. PAGES OF STORAGE 
SYSTEM SEGMENTS) 

A REGION SET ASIDE FOR SOME PURPOSE OTHER 
THAN PAGES OF STORAGE SYSTEM SEGMENTS 
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THE NEW STORAGE SYSTEM 



B SINCE RELEASE 4.0, THE MDLTICS STORAGE SYSTEM HAS BEEN ORGANIZED 
INTO PHYSICAL AND LOGICAL VOLUMES HAVING THE FOLLOWING PROPERTIES 

^1 \,U^r^ ^le0/t&k Un-.T- ie^oo-5 



I A PHYSICAL VOLUME (PV) IS A DISK PACK (MOUNTED OR NOT) 
CONTAINING: 



i A LABEL IDENTIFYING ITSELF - INCLUDING A PHYSICAL VOLUME ID 
(PVID) 

I . A VOLUME MAP. DESCRIBING WHICH PAGES and VTOCES ARE IN USE, AND 
WHICH ARE FREE. 



J A VOLUME TABLE OF CONTENTS (VTOC) DESCRIBING WHICH SEGMENTS 
ARE RESIDENT THEREIN - AND THE EXACT LOCATION OF EACH OF 
THEIR PAGES 



I THE PAGES OF RESIDENT SEGMENTS (ASSIGNED TO RECORDS OF 1024 
WORDS IN SIZE) 



I AND OPTIONALLY: CONTIGUOUS REGIONS CALLED PARTITIONS, SET 
ASIDE FOR SPECIAL USE (FDUMP IMAGES, HARDCORE PAGING, ETC) 



I ALL PAGES OF A SEGMENT RESIDE ON A GIVEN PHYSICAL VOLUME 



1 THAT IS: EACH NON-ZERO PAGE OF A SEGMENT IS ASSIGNED TO A 
RECORD OF THE PHYSICAL VOLUME 



I THE PAIR OF PHYSICAL VOLUME ID (PVID) AND VTOC INDEX UNIQUELY 
IDENTIFIES ANY SEGMENT IN THE STORAGE SYSTEM HIERARCHY 
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THE NEW STORAGE SYSTEM 



A LOGICAL VOLUME (LV) CONSISTS OF ONE OR MORE PHYSICAL VOLUMES, 
WHICH ARE: 



GIVEN ONE LOGICAL VOLUME ID (LVID) 
B ALWAYS MOUNTED AS A SET 



OFFSPRING (SONS, GRANDSONS, ETC) OF A DIRECTORY (NORMALLY) 
RESIDE WITHIN A GIVEN LOGICAL VOLUME 

I IN OTHER WORDS, A SUB-TREE (NORMALLY) SPANS NO MORE THAN ONE 
LOGICAL VOLUME ' 



DIRECTORY SEGMENTS ARE AN EXCEPTION TO THE ABOVE AS ALL 
DIRECTORY SEGMENTS ARE ASSIGNED TO A LOGICAL VOLUME OF THEIR OWN 
CALLED THE "ROOT LOGICAL VOLUME" (RLV) 

B THE PHYSICAL VOLUME CONTAINING THE ROOT DIRECTORY IS CALLED 
"THE ROOT PHYSICAL VOLUME" (RPV) 

I THE RLV IS SPECIAL BECAUSE IT MUST ALWAYS BE MOUNTED, AND IT 
CONTAIJ^'S ALL DIRECTORY SEGMENTS, BUT IT ALSO CONTAINS OTHER 
SEGMENTS 



SHOULD THE GROWING OF A SEGMENT CAUSE A PHYSICAL VOLUME TO 
BECOME FULL, A "SEGMENT MOVE" IS AUTOMATICALLY INITIATED 

n THIS IS ONE OF THE MOST COMPLEX AND EXPENSIVE SERVICES 
PERFORMED BY THE SYSTEM - BUT HAPPENS VERY INFREQUENTLY 
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THE NEW STORAGE SYSTEM 



SHOULD A LOGICAL VOLUME BECOME FULL: 



B USER. AND SYSTEM ERROR MESSAGES ARE GENERATED 



1 SPACE MUST BE OBTAINED ON THE LOGICAL VOLUME BY ADDING MORE 
PHYSICAL VOLUMES OR BY DELETING OR MOVING SEGMENTS FROM THE 
LOGICAL VOLUME 

J BECAUSE IT CONTAINS ALL DIRECTORY SEGMENTS, SPACE ON THE RLV 
IS CRITICAL: IF IT IS USED UP, THE SYSTEM MAY NOT BE ABLE TO 
CONTINUE OPERATION ..; 



J THE CHOICE OF WHICH PHYSICAL VOLUME TO USE WHEN CREATING A 
SEGMENT IS MADE IN SUCH A WAY AS TO TRY TO BALANCE THE ALLOCATED 
SPACE ON ALL THE PHYSICAL VOLUMES OF A LOGICAL VOLUME 
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THE NEW STORAGE SYSTEM 



VOLUME LABEL 
(REGISTRATION INFORMATION) 



VOLUME MAP 
(USED RECORDS MAP) 



VTOC HEADER AND 
DUMPER BIT MAP 




VTOCE's 
(ONE PER RESIDENT SEGMENT: « 15,000 VTOCE'S) 
(FIVE PER RECORD: s 3,000 RECORDS) 



UJ(£ 

DO 
OuJ 

>x 



o 

I- 
> 



<► 
<< 



PAGES OF SEGMENTS 
(ONE PER RECORD: « 35,000 RECORDS) 



<UJ 

o.ee 



> 
^ 



PARTITIONS (IF ANY) 
(SPECIAL-USE REGIONS . . . SUCH AS FDUMP IMAGES) 



38,247 



^ 
<< 



CO 

Z 
O 



oc 

< 

a, 



(RECORDS) 



(di5k„pack.incl.pl1) 



PHYSICAL VOLUME FORMAT 



(MSU451) 
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i^ 



HIERARCHY TO STORAGE SYSTEM 
MAPPING 
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EADER INFO 


H 


> 
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PV29 




HEADER INFO 


my_sat 


fil# (nap 


start_up.ae 


filamap 


. ProL.A 
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tatt 


fitemap 
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THE NEW STORAGE SYSTEM 



IF ONE KNOWS WHERE THE ROOT DIRECTORY IS, ALL SEGMENTS IN THE 
MULTICS HIERARCHY CAN BE FOUND (ASSUMING THE AVAILABILITY OF ALL 
REQUIRED PHYSICAL VOLUMES) 



B MAJOR DESIGN POINT 

MANY DISK RESIDENT DATA BASES (TO INCLUDE THE PAGES OF SEGMENTS) 
ARE COPIED INTO MAIN MEMORY AND WRITTEN BACK TO DISK AT SUCH 
TIMES AS:' 

J SYSTEM START-UP/SHUT-DOWN 

I PHYSICAL VOLUME MOUNTING /DEMOUNTING 

B SEGMENT ACTIVATION /DEACTIVATION 

• B PAGE FAULTS 



WHILE IN MAIN MEMORY, THE MEMORY RESIDENT COPY 'IS CONSIDERED TO 
BE THE COPY 



WHILE IN MAIN MEMORY, THE DISK RESIDENT COPY IS CONSIDERED TO BE 
(AND OFTEN IS) WHOLLY INVALID 
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THE NEW STORAGE SYSTEM 
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MULTICS DISK PACK STATISTICS (MSU 451) 



THE ABOVE FIGURES APPEAR INCONSISTENT IF 
DATA FORMATTING IS NOT CONSIDERED 
{E.G.: SOME DISK SPACE IS NOT USED) 
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LOGICAL VOLUME 
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LOGICAL VOLUME 
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LOGICAL VOLUME 



LOGICAL VOLUMIE/MASTER DIRECTORY REUTIONSHIP 

* NOTE ; ALL DIRECTORY SEGMENTS RESIDE ON ONE DESIGNATED 

LOGICAL VOL UME CALLED THE ROOT LOGICAL VOLUME (RLVI 
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VOLUME MANAGEMENT TERMINOLOGY 



MOUNT: 



TO PHYSICALLY PLACE A DISK PACK ON A DRIVE AND CYCLE UP 
THE DRIVE, {PERFORMED BY THE OPERATOR, NOT BY 
SOFTWARE) 



ACCEPT: 



AFTER MOUNTING, TO ESTABLISH IN THE SUPERVISOR THE 
BINDING BETWEEN THE DRIVE AND THE PHYSICAL VOLUME 
MOUNTED 



PUBLIC :•: 



'ALOGICAL. VOLUME ATTRIBUTE INDICATING THAT THE VOLUME- 
IS ATTACHED TO ALL PROCESSES (BY DEFAULT) WHEN ACCEPTED 



PRIVATE: 



A LOGICAL VOLUME ATTRIBUTE INDICATING THAT THE VOLUME 
ACCESS CONTROLS) 



PARTITION: A REGION WITHIN A PHYSICAL VOLUME SET ASIDE FOR SPECIAL 
USE 



RECORD! 



A LOGICAL UNIT OF DISK SPACE, 1024 CONTIGUOUS WORDS IN 
SIZE. , (NUMBERED/ADDRESSED FROM ZERO) 



IK 



l^f^lfl/^ 



SECTOR: 



A LOGICAL UNIT OF DISK SPACE, 64 CONTIGUOUS WORDS IN 
SIZE. THB-^MALLEST ADDRESSABLE UNIT OF DISK SPACE. A 
RECORD CONTAINS 16 SECTOSS — "^ " : 
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VOLUME MANAGEMENT TERMINOLOGY 



PAGE: A 1024 WORD EXTENT OF DATA STARTING AT A 1024 WORD 

BOUNDARY OF A SEGMENT. SEGMENTS MUST BE AN INTEGER 
NUMBER OF PAGES IN SIZE. A PAGE CAN RESIDE IN ONE OR 
MORE OF THE FOLLOWING LOCATIONS: 

MAIN MEMORY FRAME 
DISK RECORD 
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VOLUME MANAGEMENT DATA BASES 



VOLUME LABEL 
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8 WORDS: "IMtkt Steragt Sy>nm VdunM" 




«MORDS CONTAIN me MANUFACTURE'S SERIAL NIMBER 
:. S iMHIDS CONTAINING PHYSICAC. VOLUWE NAME 
8 HWROS CONTAINING LOGICAL VOLUME NAME 
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PHYSICAL VOLUME IDENTIFIER (PVIO) 


LOGICAL VOLUME IDENTIFIER (LVID) 


PVIO OF THE ROOT PHYSICAL VOLUME 


TIME REGISTERED 
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VOLUME SIZE (NO RECORDS! 

ft 






VTOC SIZE (NO RECORDS) ' 
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MAXIMUM AIM CLASSIFICATION IN VOLUME 


MINIMUM AIM CLASSIFICATION IN VOLUME 


' — \ ■ -1 




1 



18 WORDS NOT USED 
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VOLUME MANAGEMENT DATA BASES 
VOLUME LABEL 
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VOLMAP VERSION lOVERLAYSOLD TIME-UNMOUIMTEDI 1 
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TIME SALVAGED 




TIME OF BOOTLOAO 


TIMi UNMOUNTED 
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712 

7-13 



8 WORDS USED BY VOLUME DUMPER 
48 WORDS UNUSED 



VTOC INDEX OP 



X 



DIRECTORY 



SHUTDOWN STATE 



OISIC_TAaLE_ VTOC INDEX 



DISK_TABL£.. UNIQUE ID 



ESO STATE 



VOLUME MAP ORIGIN RECORD 



VOLUME MAP SIZE 



VTOC MAP ORIGIN RECORD 



VTOC MAP SIZE 



VOLUME MAP SECTION SIZE 



VTOC ORIGIN RECORD 



DUMPER BIT MAP RECORD 



VOLUME INCONSISTENCY COUNT 



52 WORDS UNUSED 
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NUMBER OF PARTITIONS 


PARTtTION ID NAME 
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PARTITION (1) LOCATION 
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•ABTITION'I'SIZE 
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188 WORDS DESCRIBING PARTITIONS 2 THRU A7 



320 WORDS (5 SECTORS) NOT USED 
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VOLUME LABEL 

A DISK RESIDENT DATA BASE - ONE PER PHYSICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 



VOLDME LABEL 



B THE VOLUME LABEL IS A DISK RESIDENT DATA BASE OCCUPYING THE FIRST 
MULTICS RECORD OF EACH STORAGE SYSTEM PHYSICAL VOLUME 



i ONE VOLUME LABEL PER PHYSICAL VOLUME 



THE LABEL IS GENERATED BY init disk_pack { init_empty_root IF RPV 
LABEL) AND CONTAINS. REGI STRATI 0N"AND STATUS INFORMATION 



THE LABEL IS INSPECTED WHEN THE VOLUME IS ACCEPTED AND UPDATED WHEN 
DEMOUNTED 



s THE LABEL IS DIVIDED- INTO SIS SECTORS 



B GCOS REGION (SECTORS TO 4) 



SKIPPED OVER BY MULTICS TO AVOID ACCIDENTAL OVERWRITING OF 
GCOS PACKS AND ALLOW FOR FUTURE COMPATABILITY 



8 PERMANENT REGION . (SECTOR 5) 

CONTAINS PERMANENT PER-PV INFORMATION (EG: MANUFACTURERS 
SERIAL NUMBER) 
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VOLUME MANAGEMENT DATA BASES 



VOLUME LABEL 



I DYNAMIC INFORMATION REGION (SECTOR 6) 

CONTAINS INFORMATION RELATING TO THE MOST RECENT MOUNTING OF 
THE PV (EG: LAST MOUNT TIME) 

ALLOWS THE STORAGE SYSTEM TO ENSURE THE INTEGRITY OF THE PV 



I ROOT INFORMATION REGION (SECTOR 7) 

I "DEFINED only: FOR THE' ROOT PHYSICAL VOLUME. 

B CONTAINS DYNAMIC INFORMATION ABOUT THE ENTIRE STORAGE SYSTEM 
(EG:- SHUT DOWN STATE, PAGING DEVICE STATE, ETC) ■ 

B PARTITION MAP (SECTOR 8) 

IDENTIFIES THE LOCATION AND LENGTH OF ANY RESIDENT PARTITIONS 

O UNUSED (SECTORS 9 TO 13) 
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VOLUME MANAGEMENT DATA BASES 



VOLUME MAP 



111111111122J2222222333333 

012345678901234567890123456789012345 



16-0 



17-0 



63-63 



SIZE OF PAGING REGION 



LOCATION OF PAGING REGION 
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NUMBER OF VACANT RECORDS 



— IIIIIM M lll H I W IMIWW>*W4«*f W M IIIWllllltlltMiNMi*pHMi HH fcl.t»< 



aZEOFSITMAP 



(SECTOR - WORD) 
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60 WORDS NOT USED 



BIT MAP OF FIRST 32 RECORDS 



BIT MAP OF SECOND 32 RECORDS 



BIT MAP OF 3008th 32 RECORDS 
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(ft_val._map.inei.pi1 1 
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VOLUME MAP 

A DISK RESIDENT DATA BASE - ONE PER PHYSICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 
VOLUME MAP 

B THE VOLUME MAP IS A DISK RESIDENT DATA BASE 



OCCUPIES RECORDS 1, 2, AND 3, IMMEDIATELY FOLLOWING THE VOLUME 

LABEL 



ONE VOLUME MAP PER PHYSICAL VOLUME 



THE VOLUME MAP' IDENTIFIES THE EXTENT OF THE PAGING REGION, THE 
NUMBER OF VACANT RECORDS, AND THE STATE (VAC ANT /OCCUPIED) OF EVERY 
RECORD IN THE VOLUME'S PAGING REGION 



II THIS INFORMATION IS ALSO DERIVABLE FROM AN ANALYSIS OF THE VTOC 
(AT CONSIDERABLE EXPENSE) - THIS IS DONE WHEN THE VOLUME IS 
SCAVENGED OR SALVAGED. 



RECORDS ARE TAKEN FROM THE VOLUME MAP DURING OPERATION AND PLACED 
IN THE RECORD STOCK 



RECORDS ARE ALLOCATED BY PAGE CONTROL FROM THE RECORD STOCK 



VOLUME MAP ON DISK IS ALWAYS CONSISTENT 

I RECORDS MARKED FREE ON DISK ARE GUARANTEED TO BE FREE, AND 
SAFE TO RE-USE 
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VOLUME MANAGEMENT DATA BASES 



VOLUME MAP 



II RECORDS MARKED AS ALLOCATED MAY NOT ACTUALLY BE IN-USE, IF A 
CRASH OCCURRED AND DESTROYED THE STOCK CONTENTS 



THIS SITUATION IS BENIGN, AND CORRECTED BY A. SCAVENGE OR 
SALVAGE AT SOME CONVENIENT TIME 



I RECORDS FREED ARE PLACED BACK IN THE STOCK 

B IF STOCK FILLS, IT IS WRITTEN BACK TO THE VOLUME MAP 

CONSISTENCY IS ENSURED BY COMPLEX PROTOCOL IN PAGE CONTROL 



I RECORD STOCK MECHANISM REPLACES FSMAP SEGMENTS IN PRE-MRIO.O 
SYSTEMS 



Not To Be Reproduced 6-21 F80A 



VOLUME MANAGEMENT DATA BASES 
DUMPER BIT MAP 




1 
2 
3 



1023 



NUMBER OF VTOCES 



NUMBER OF FREE VTOCES 



NUMBER OF WORDS USED IN BIT MAP 



NUMBER OF LAST RECORD IN VTOC 




VTOC BIT MAP ENTRY 



VTOC BIT MAP, ENTRY 1015 



2047 



VOLUME DUMPER BIT MAP 
RECORDS 4 AND 5 




VOLUME DUMPER BIT MAP ENTRY 



VOLUME DUMPER BIT MAP ENTRY 2039 



VTOC WAP 

RECORD 6 
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VOLUME MANAGEMENT DATA BASES 



DUMPER BIT MAP 



8 THE DUMPER BIT MAP DESCRIBES WHICH VTOCES ON THE VOLUME HAVE BEEN 
VOLUME DUMPED 



B ONE PER PHYSICAL VOLUME 

8 OCCUPIES RECORDS 4. AND 5, IMMEDIATELY FOLLOWING VOLUME MAP 

1, SEPARATE BIT MAPS FOR INCREMENTAL AND CONSOLIDATED VOLUME DUMPS 
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VOLUME MANAGEMENT DATA BASES 
VTOC MAP 



THE VTOC MAP DESCRIBES THE LOCATION AND SIZE OF THE VTOC, AND 
CONTAINS A BIT MAP OF VTOC ALLOCATIONS 



B OCCUPIES RECORD 6, IMMEDIATELY FOLLOWING THE DUMPER BIT MAP 
D VTOC FOLLOWS, STARTING AT RECORD 8 
RECORD 7 IS UNUSED 



B VTOCES ARE TAKEN FROM THE VTOCE MAP AND PLACED IN AN ONLINE STOCK 

I VTOCE STOCK IS LIKE RECORD STOCK, BUT LESS CRITICAL 

J VTOCES ARE SELF-IDENTIFYING AS TO WHETHER THEY ARE IN USE OR 
NOT, SO IT IS NOT NECESSARY TO MAINTAIN PERFECT CONSISTENCY 
IF A CRASH OCCURS 

1 VTOCE MAP IS ALSO REBUILT BY SCAVENGE OR SALVAGE OPERATIONS 
B VTOCE MAP REPLACES VTOCE FREE LIST IN PRE-MRIO.O SYSTEMS 
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VOLUME MANAGEMENT DATA BASES 



NUMBER OF ENTRIES 



MAXIMUM NUMBER OF ENTRIES 



NUMBER OF ENTRIES IN USE 





5 WORDS FOR SHUTOOim STATUS 








TIMEOFBOOTUMa 
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1 — 





» WORDS OF INFORMATION ABOUT RPV AND RLV 

21 WORDS OF GLOBAL INFORMATION ANO 

METERING CELLS FOR VOLUME MAFS 

- ANO VTOC MAF5 



-I. 



ARRAY OF PHYSICAL VOLUME TABLE ENTRIES 

PHYSICAL VOLUME TABLE ENTRY (PVTE) 

ONE PER PHYSICAL VOLUME 

LOCATED IN PHYSICAL VOLUME TABLE 



2 
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4 
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6 
7 
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» 
10 
11 



mvSCAL VQUWE 10 



LOGICAL VOLUME ID 



SKIPPED FOR POIR ALLOCATION 



NEXTPVINLV 



DISK SUBSYSTEM NAME „ . 



DISK DRIVE TYPE 



k'. ^^K<r\. 



DISK DRIVE NUMBER 



FREE VTOCE COUNT 



INC. OUMPER BIT MAP POINTER 



FREE RECORD COUNT 
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JL._ 
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zjm. 



V I M 

A C 
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I ■ T 



VTOC SCZE (IN RECORDS) 



CONS. DUMPER BIT MAP POINTER 



TOTAL RECORD COUNT 



DISK DIM INFORMATION 



INC CiUMPER VTOC INDEX 



COMP. DUMPER VTOC INDEX 



CONS. OUMPER VTOC INDEX 



TOTAL VTOCE COUNT 



FIRST RECORD IN PAGING REGION 



hrt 



9 WORDS FOR VOLUME MAP ANO VTOC MAP INFORMATION 



1 



VOLUME TROUBLE COUNT 



SCAVENGER INFO POINTER 



a,T OF 
Not To Be Reoroduced 



PHYSICAL VOLUME TABLE HEADER 
A HARDCORE (WIRED) DATABASE - ONE PER SYSTEM 
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VOLUME MANAGEMENT DATA BASES 
PHYSICAL VOLUME TABLE (PVT) 



B THE PHYSICAL VOLUME TABLE (PVT) IS A HARDCORE, WIRED, PAGED DATA 
BASE MAINTAINED BY VOLUME MANAGEMENT 



ONE PVT PER SYSTEM 



THE PVT IS THE MOST IMPORTANT DATA BASE OF VOLUME MANAGEMENT, AND 
CONTAINS AN ARRAY OF PHYSICAL VOLUME TABLE ENTRIES (PVTE'S) 



B ONE PVTE PER DISK DRIVE KNOWN TO THE SYSTEM 



B EACH PVTE DESCRIBES; 



A DISK DRIVE CONFIGURED TO THE SYSTEM 



B INCLUDING THE DEVICE NUMBER, DEVICE TYPE, SUBSYSTEM NAME AND 
OTHER INFORMATION NEEDED BY THE DISK DIM 



THE PHYSICAL VOLUME CURRENTLY MOUNTED ON THE DISK DRIVE 



INCLUDING THE PVID, LVID, AND OTHER INFORMATION TAKEN FROM 
THE VOLUME HEADER,. VOLUME MAP AND VTOC MAP, NEEDED BY PAGE 
AND SEGMENT CONTROL (THE PV & LV NAMES ARE NOT RECORDED HERE) 



RECORD AND VTOCE STOCKS ARE LOCATED FROM THE PVT, BUT KEPT IN 
THE stock_seg 
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VOLUME MANAGEMENT DATA BASES 
LOGICAL VOLUME TABLE (LVT) 



1t1t111111z2222 2. 2222333333 
01234S57>901231SI783012:<5a7S9012345 



MAX LVTE INDEX 
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HI6H WATER LVTE INDEX 
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Vfl- 
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FIRST FREE LVTE POINTER 








i^— 


—t 




^^^^^^ 


■ ■■■ 
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4 WORDS NOT USED 



MWOROS OF LVTE POINTERS USED 
AS A HASH TABLE 



POINTER TO NEXT LVTE 



FIRSTPVTER PTR 



S , 



LOGICAL VOLUME 10 (LVIO) 



MINIMUM AIM CLASSIFICATION 
IN LOGICAL VOLUME 



MAXIMUM AIM CLASSIFICATION 
IN LOGICAL VOLUME 



ALLOCATION ALGORITHM VALUE 



OTHER LVTE'j 
ONE PER MOUNTED LOGICAL VOLUME 



(WORDS 



LOGICAL VOLUME lABLE (LVT) 

A HARDCORE DATA BASE - (ME PER SYSTEM 



LOGICAL VOLUME lABLE ENTRY (LVTE) 

ONE PER MOUNTED LOGICAL VOLUME 



IhrtineUIII 
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VOLUME MANAGEMENT DATA BASES 



LOGICAL VOLUME TABLE (LVT) 



THE LOGICAL VOLUME TABLE (LVT) IS A HARDCORE, PAGED DATA BASE 
MAINTAINED BY VOLUME CONTROL 



J ONE LVT PER SYSTEM 



B THE LVT CONTAINS AN ARRAY OF LOGICAL VOLUME TABLE ENTRIES (LVTE'S) 



B ONE LVTE FOR EACH MOUNTED LOGICAL VOLUME 



B EACH LVTE DESCRIBES THE LOGICAL VOLUME TO INCLUDE: 



D LVID AND AIM CLASSIFICATION 



RELATIVE POINTER TO THE THREAD OF PVTE'S OF ACCEPTED PHYSICAL 
VOLUMES THAT ARE MEMBERS OF THE LOGICAL VOLUME 
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VOLUME MANAGEMENT DATA BASES 
LOGICAL VOLUME TABLE (LVT) 

B THE LVT IS REQUIRED AT THE FOLLOWING TIMES: 
i SEGMENT CREATION 
SEGMENT MOVING TIME 
8' VOLUME MOUNTING AND DEMOUNTING 
S INITIATION AND SEGMENT FAULT TIME {FOR PUBLIC/PRIVATE CHECK) 
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VOLUME MANAGEMENT DATA BASES 
PHYSICAL VOLUME HOLD TABLE 



63 



1 2 


1 
34S67g90 


111111 
2 3 4 5 6 7 


1 
8 


2222222222333333 
90123456789012345 


PVT R_PTR(1) 


APTE R_PTR (1) 


PVT R_PTR (2) 


ARTE R_PTR(2) 


• 


• 


PVT R_PTR 164) 




APTE R_PTR (64) 





(WORD) 



(pv_holclt.inct.pI1) 



PHYSICAL VOLUME HOLD TABLE 

AN INTERNAL STATIC ARRAY IN 9n_pin>t - ONE PER SYSTEM 



B THE PHYSICAL VOLUME HOLD TABLE (PVHT) IS A HARDCORE DATA BASE 
MAINTAINED BY VOLUME MANAGEMENT 



O ONE PVHT PER SYSTEM 



B THE PVHT IDENTIFIES THE PHYSICAL VOLUME AND THE PROCESS ID OF 
PROCESS THAT HAS STARTED (AND HAS NOT YET COMPLETED) COMPOUND 
OPERATIONS UPON THE PHYSICAL VOLUME 



B THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE SUCH 
AN OPERATION IS IN PROGRESS 
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VOLUME MANAGEMENT DATA BASES 
PHYSICAL VOLUME HOLD TABLE 



S INTERRUPTION OF A COMPOUND OPERATION CAUSES THE VOLUME TO BE MARKED 
AS CONTAINING AN INCONSISTENCY 



B FOR CRASH ANALYSIS, SSt.pvthp CONTAINS A POINTER TO THIS TABLE 
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VOLUME MANAGEMENT OPERATIONS 
ACCEPTANCE OF PHYSICAL VOLUMES 



THE ACCEPTANCE OF PHYSICAL VOLUMES IS THE MOST IMPORTANT AND 
FUNDAMENTAL OPERATION OF VOLUME MANAGEMENT 



PHYSICAL VOLUME ACCEPTANCE IS ACCOMPLISHED BY CALLING 
initializer_gate_$accept_f s_disk 



THE ROOT PHYSICAL -VOLUME (RPV) IS ACCEPTED IN A SPECIAL FASHION 
DURING COLLECTION 2 OF BOOTLOAD 



THE RPV IS THE ONLY PV REQUIRED TO BOOTLOAD THE SYSTEM (MORE OF 
THE RLV WILL BE ACCEPTED BY RING ZERO DURING BOOTLOAD IF POINTED 
TO BY THE "ROOT" CONFIGURATION CARD) 



B ACCEPTANCE INCLUDES: 



VALIDATE THAT THE DISK PACK MOUNTED IS THE PACK REQUESTED BY THE 
OPERATOR OR REQUESTING PROCESS VIA label. pvid 



DETERMINE THAT THE DISK PACK MOUNTED IS IN FACT A MEMBER OF THIS 
HIERARCHY VIA label . root_pvid 



J INITIALIZING THE APPROPRIATE PVTE WITH DATA FROM THE LABEL, 
VOLUME MAP, AND VTOC MA.P 
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VOLUME MANAGEMENT OPERATIONS 



ACCEPTANCE OF PHYSICAL VOLUMES 



J INITIALIZING THE INITIAL CONTENTS OF THE RECORD STOCK AND VTOCE 
STOCKS 



I DETERMINING IF ANY VOLUME INCONSISTENCIES ARE PRESENT, AND 
LOGGING THIS INFORMATION 

5 VOLUME INCONSISTENCIES ARE CAUSED BY EVENTS WHICH MAY MEAN 
THAT THE DISK RESIDENT COPY OF THE VOLUME MAP OR VTOC MAP IS 
INCONSISTENT:.;: 

I -A CRASH WITOOUT; ESD - INDICATED BY label. time_map updated 
• ' and " label. time_unmounted BEING " UNEQUAL, DETECTED AT 
ACCEPTANCE TIME 

AN INCONSISTENCY DETECTED ONLINE, SUCH AS AN INVALID VTOC 
BIT MAP OR A REUSED ADDRESS 

S AN I/O ERROR «HEN WRITING THE VOLUME MAP OR VTOC MAP 
DURING NORMAL OPERATION 

I A COUNT IS KEPT IN THE LABEL, AND UPDATED AS NECESSARY . 

I NORMALLY, INCONSISTENCIES ARE MERELY LOGGED, AND' LEFT FOR THE 
SITE TO TAKE CARE OF AT SOME CONVENIENT TIME 

IF AN RLV VOLUME CLAIMS ONLY A VERY SMALL NUMBER OF FREE 
PAGES, A VOLUME SALVAGE IS DONE AUTOMATICALLY TO TRY TO 
RECOVER ANY LOST DUE TO THE INCONSISTENCY, SINCE A FULL 
RLV WILL CAUSE SYSTEM CRASHES 
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VOLUME MANAGEMENT OPERATIONS 
ACCEPTANCE OF PHYSICAL VOLUMES 



I . WRITING OUT THE LABEL TO UPDATE label . time_map_updated. . 

I NOTE: label. time map_updated AND label .time_unniounted ARE 
NOW UNEQUAL 

THIS INEQUALITY IMPLIES THAT THE VOLUME HAS NOT BEEN PROPERLY 
SHUT DOWN, AND WILL BE MARKED INCONSISTENT IF ACCEPTED AGAIN 
IN THIS STATE 



J MARKING THE PVTE AS "IN USE" (LAST STEP) 
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VOLUME MANAGEMENT OPERATIONS 
DEMOUNTING OF PHYSICAL VOLUMES 



a THE DEMOUNTING OF PHYSICAL VOLUMES INVOLVES REVERSING ALL OF THE 
STEPS TAKEN AT ACCEPTANCE TIME 



Bt DEMOUNTING IS COMPLICATED BY THE FACT THAT THE PV MAY BE IN USE AT 
THE TIME 



»■ "DEMOUNTING IS ACCOMPLISHED BY CALLING demount_pv ("THE DEMOUNTER") 



8 ALL VOLUJffiS ARE DEMOUNTED AT SHUTDOWN Tlhffi 



a DEMOUNTING INCLUDES; 



TURNING ON pvte .being_demounted AND WAITING FOR ALL COMPOUND 
OPERATIONS TO TERMINATE 



DEACTIVATING ALL SEGMENTS FROM THE pV WHICH ARE ACTIVE. THIS 
INCLUDES: 



FLUSHING MAIN MEMORY AND PAGING DEVICE {IF PRESENT) OF ALL 
RELEVANT PAGES 
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VOLUME MANAGEMENT OPERATIONS 
DEMOUNTING OF PHYSICAL VOLUMES 



J UPDATING THE VTOCE'S FROM THE ASTE'S AND PAGE TABLES 



FLUSHING THE VTOC MANAGER'S BUFFER SEGMENT OF ALL RELEVANT 
VTOCE-PARTS 



J EMPTYING THE RECORD AND VTOCE STOCKS BACK INTO THE VOLUME MAP 
AND VTOC MAP 



I UPDATING THE VOLUME LABEL FROM THE PVTE, PARTICULARLY 

I label. time_unniounted, label. tinie_map_updated, AND 
label. inconsistency_count 



B PHYSICALLY CYCLING DOWN THE DISK DRIVE 
j NOT DONE AT SYSTEM SHUTDOWN, HOWEVER 



B ■ ONLY ONE PV MAY BE DEMOUNTED AT A TIME 
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VOLUME MANAGEMENT OPERATIONS 



LOGICAL VOLUME MANAGEMENT 



B LOGICAL VOLUME MANAGEMENT INCLUDES: 



I MAINTAINING THE LOGICAL VOLUME TABLE (LVT) TO REFLECT THE STATE 
OF THE LOGICAL VOLUMES 



I MAINTAINING, IN THE KNOWN SEGMENT TABLE (KST) OF EACH PROCESS, A 
TABLE OF PRIVATE LOGICAL VOLUMES MOUNTED TO THE PROCESS 



ff ANSWERING THE QUESTION OF WHETHER OR NOT A GIVEN LOGICAL VOLUME 
IS MOUNTED TO THE CALLING PROCESS 

i OR, IF A PUBLIC LV, MOUNTED AT ALL {TO THE SYSTEM) 



I PROVIDING THE HEAD OF THE PVT CHAIN FOR A GIVEN LV, FOR THE 
SEGMENT CREATION FUNCTION 
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VOLUME MANAGEMENT COMMANDS 



p-rint configuration deck 



PRINT CONFIGURATION_DECK - DISPLAYS >sll>conf ig_deck , WHICH 
CONTAINS INFORMATION ABOUT DISK LOCATIONS, THE RLV, AND PARTITIONS 



B ONLY THE PART OF THE CONFIG DECK RELEVANT TO VOLUME MANAGEMENT 
AND DISK CONFIGURATION IS SHOWN HERE 



root dska 16. dskb 25. dskb 23. dskb 24. dska 8, 



■pa ft' " 'bos ds ka ■ ' 1 5 .' 
part dump dska 16. 
part'- log dska .16. 



prph 


dska 


a 


20. 


2 


451. 


16. 








chnl 


dska 


a 


26. 


2 


b 


24 


. 2 


b 


22. 


2 


prph 


dskb 


b 


20. 


2 





16 


. 45J 


.. 


16. 




chnl 


dskb 


b 


26. 


2 


a 


24 


. 2 


a 


22. 


2 


prph 


dskc 


a 


28. 


2 


501. 


32. 








chnl 


dskc 


a 


30. 


2 


b 


30 


. 2 


b 


28. 


2 


prph 


dske 


b 


32. 


2 


451. 


8. 








^ ^ 


t , 1 


i_ 


•^ m 


^ 














cnni, 


UbKe 


CI 


o* . 


^ 














prph 


dskf 


a ■ 


32. 


2 


501. 


16. 








chnl 


dskf 


a 


34. 


2 














mpc 


mspa 


451 


a 


20 




4 


a 24 




4 




mpc 


mspb 


451 


. b 


20 




4 


b 24 




4 




mpc 


mspc 


607 


a 


28 




4 










mpc 


mspd 


607 


. b 


28 




4 










mpc 


mspe 


451 


. b 


32 




4 










mpc 


mspf 


607 


Q 


32 




4 
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VOLUME MANAGEMENT COMMANDS 
print conf icuration deck 



s DISK CONFIGURATION CONFIG CARDS 



i ROOT 



J IDENTIFIES THOSE VOLUMES IN THE ROOT LOGICAL VOLUME WHICH 
HAVE H& PARTITIONS, USED BY THE SUPERVISOR FOR PAGING OF 
SUPERVISOR SEGMETNS 



B PART 

. IDENTIFIES THE LOCATIONS OF CERTAIN IMPORTANT PARTITIONS 

ONLY PARTITIONS NECESSARY FOR MULTICS OPERATIONS ARE 
IDENTIFIED, NOT ALT PARTITIONS 

HC PARTITIONS ARE LOCATED BY THE ROOT CARD 

PRPH DSKn, CHNL 

S IDENTIFY PHYSICAL I/O CHANNEL 'PATHS FOR ACCESSING DISK DRIVES 

D MPC 



B IDENTIFY PHYSICAL CONNECTIONS TO MICROPROGRAMMED DISK 
CONTROLLERS 
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VOLUME WANAGlWEK'T COmANDS 
1 i St vols 



E LIST VOLS - DISPLAYS A TABLE OF ONLINE VOLUMES, THEIR LOCATION, AND 
SPACE UTILIZATION 



Drive 


Recorcs 


Left 


% VTOCEs 


Left 


% A 


vg 


PV 


PB/PD 


LV Name 














S 


ize 


Name 






cskc_17 


GkSOk 


54730 


85 


13440 


11356 


84 


4 


alphabl 


pb pd 


Alpha 


aEkc_18 


GkBOU 


55389 


86 


13440 


11352 


84 


4 


alphs02 


pb pd 


Alpha 


SEkS~05 


36i*26 


5305 


15 


8400 


2662 


32 


•5 


mu103 


pb pd 


Mul tics_Pubs 


dska_Oc 


36428 


4323 


12 


8400 


2365 


28 


5 


mulOl 


pb pd 


nul t ics_Pubs 


dskb~!9 


36428 


4632 


13 


8400 


2B13 


33 


5 


mul02 


pb pd 


rtul tics_Pubs 


dskD_26 


36429 


13690 


38 


8400 


4326 


52 


5 


mulO? 


pb pd 


Mul tics_Pubs 


dskb~27 


36429 


4672 


13 


8400 


2333 


28 


5 


mul04 


pb Dd 


Multics Pubs 


cska_OI 


36308 


4680 


13 


9000 


450 


5 


3 


pubOl 


pb Dd 


Publi: ~ 


dsk2~03 


3o26S 


35B8 


10 


9200 


1017 


11 




pub07 


pp pd 


Publ Ic 


dska_Oi, 


36268 


450C 


12 


9200 


884 


10 


3 


pubOL 


pb pd 


Pub I i c 


dskc_05 


3626E 


4£ 16 


13 


9200 


864 


9 


^ 

^ 


pubC2 


pb pd 


PuDl Ic 


dskb~]7 


3626S 


425! 


12 


5200 


1002 


11 


3 


pub05 . 


p= pd 


Pub! ic 


cskb_15 


36268 


3840 


11 


5200 


539 


6 


3 


pub08 


pb pd 


Publ i c 


askc_13 


64504 


294 





13440 5539 


41 


8 


relOl 




Release 


dskc~U 


64504 


269 





1344c 


5214 


39 


/ 


rel02 




Release 


dskc~Cl 


6^503 


43631 


68 


13440 


IC032 


75 


6 


xpubOl 


pb 


XduSI ic 


dskc_C;2 


64503 


45502 


71 


13440 


9638 


73 


5 


xpuD02 


pb 


Xpub' ic 


dEkc_03 


64503 


42374 


66 


13440 


9839 


73 


6 


xpub03 


pb 


Xpub! Ic 


askc_Ci, 


64503 


43591 


68 


13440 


5785 


73 


5 


xpub04 


pb 


Xpucl ic 


dskc_09 


6450L 


58010 


90 


13440 


12394 


92 


6 


xpub05 


pb 


Xpjbl ic 


a5kc_lD 


64504 


56786 


.88 


13440 


12407 


92 


7 


xpubOo 


pb 


Xpubl ic 


askc_2 1 


64503 


23947 


57 


13^-40 


6446 


48 


5 


ypubOl 


pb 


Ypubl ic 


cskc~22 


64503 


237i*4 


37 


1344c 


6194 


46 


'5 


ypub02 


pb 


YpUD 1 i C 


dskc~2S 


64503 


23794 


37 


13i*40 


6185 


46 


5 


ypub05 


pb 


Ypubl 'C 


dskc_30 


64503 


24111 


37 


13440 


64S1 


48 


5 


ypub06 


pb 


Y Dub 1 : c 


dsKcl07 


64503 


11723 


18 


■3440 


6149 


•40 


7 


zpubO 1 


■ pb pd 


Zpub 1 i c 


askc^OB 


6^503 


11665 


18 


13440 


6429 


48 


7 


2pub02 


pb DO 


Zpubl i c 


dskc_23 


64504 


9777 


15 


13440 


6O94 


45 


7 


2pub03 


pb pd 


Zpubl ic 


dskc_2i4 


64504 


11805 


18 


13440 


6141 


46 


7 


2pub04 


pb pd 


Zpubl ic 


dskc_25 


64504 


11514 


18 


13440 


7407 


55 


8 


2pub05 


pb pd 


Zpubl ic 


dskc~26 


64504 


12958 


20 


13440 


7149 


53 


8 


zpub06 


pb pd 


Zpubl i c 


dske~Ob 


37089 


8053 


22 


5100 


3797 


74 


22 


1 istOl 


pb pd 


1 ist_l 


dska_12 


37562 


6046 


16 


2735 


957 


35 


17 


nst02 


pb 


1 ist_2 


dska~07 


37309 


6825 


18 


4000 


2107 


55 


16 


I ist03 


pb 


1 ist~3 


dska_08 


36209 


3827 


11 


7000 


491 


7 


4 


root5 


pb 


root 


dska 11 


36209 


8597 


24 


7000 


4181 


60 


9 


root6 


pb 


root 


dska_16 


31283 


2892 


9 


9000 


3476 


39 


5 


rpv 


pb 


root 


dskb_23 


36208 


4S8S 


13 


7000 


455 


7 


4 


root3 


pb 


root 


dskb~2A 


36209 


3097 


9 


7000 


238 


3 


4 


root4 


pb 


root 


dskb_25 


36350 


4483 


12 


7000 


223 


5 


4 


root2 


pb 


root 
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VOLUME MANAGEMENT COMMANDS 



display label 



DI SPLAY_LABEL - DISPLAYS THE LABEL 
READING IT FROM DISK 



OF A STORAGE SYSTEM VOLUME BY 



USED / FREE INFORMATION IS COPY ON DISK, AND 
DATE WITH RESPECT TO THE PVTE 



THEREFORE OUT OF 



Label for Multics Storage System Volume rpv on dska_01 d451 
PVID 220531524345 

Serial rpv 

Logical Volume root 

LVID 220531524466 



Registered 


01/28/81 


1249. 


.5 


Dismounted 


03/15/83 


0741. 


.9 


Map Updated 


03/15/83 


0744. 


.6 


Salvaged 


10/01/82 


0300. 


.3 


Boot load 


03/15/83 


0743. 


.5 


Reloaded 


01/28/81 


1510, 


.1 


Dumped 








Incremental 


03/17/83 


2153. 


.0 


Consolidated 


03/16/83 


2359. 


.3 


Complete 


03/15/83 


2353. 


.0 


Inconsistencies 









Minimum AIM 


0:000000 






Maximum AIM 


7:777777 







Volume contains Root {>) ai 
disk table at vtocx 100 



vtocx 
(uid 033022210261) 



Volume Map from Label 



First Rec 


(Octal) 


Size 












8 


Label 


Region 


8 


10 


2000 


VTOC 


Region 


2008 


3730 


2008 


he 


Partition 


4016 


7660 


33901 


Paging 


Region 


37917 


112035 


200 


bos 


Partition 


38117 


112345 


141 


alt 


Partition 






38258 


Total 


Size 
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VOLUME MANAGEMENT COMMANDS 
display pvte 



B DISPLAY PVTE - DISPLAYS THE PVT ENTRY OF A STORAGE SYSTEM VOLUME 



PARTITION INFORMATION IS NOT DETAILED IN THE PVTE, BUT USED /FREE 
INFORMATION IS COMPLETELY UP TO DATE 



PVTE for Multics Storage System Volume rpv on dska_01 d45l at pvt | 50 
PVID 22053.1524345 

LVID 220531524466 

VTOCEs 

Number lOOOO 

Left 3323 

Records 

Number 33901 

Left 3796 

Inconsistencies _ 

Volume Map 

volmap_seg ASTE 15 | 4420 

record stock 76|100 

Page - Base 7660 

•m TOC/l 

Page 1 - Base 103660 

Free 3740 

Page 2 - Base 203660 

Free 

vtoce stock 76|2400 

ON: storage_system permanent hc_part_used 

OFF: being_mounted being_demounted being_demounted2 
scav_check_address device_inoperative vacating 
dmpr~in_use( incr ) dmpr_in_use(cons) dmpr_in_use(comp) 

Volume Map from PVTE 



First Rec 


(Octal) 


Size 










8 


Label Region 


8 


10 


2000 


VTOC Region 


2008 


3740 


2008 


Partitions 


4016 


7660 


33901 


Paging Region 


37917 


112035 


199 


Partitions 






38258 


Total Size 
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VOLUME MANAGEMENT METERS 



disk meters 



S DISK_METERS - DISPLAYS I/O ACTIVITY TO DISK DRIVES 



I ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 



Total metering time 


0:20:12 






« 




Subsystem 


dska 


Count 


Waits 


%Waits 


Avg. Wait{ms. 


) 


call locks 


26005 


217 


0.83 


0.259 




run locks 




112 





0.00 


0.000 




interrupt 


locks 


25998 


239 


0.92 


0.208 




allocations 


26001 





0.00 


0.000 




Drive 


Reads 


Writes 


Seek 


ATB 


ATB 


ATB 








Distance 


Reads 


Writes 


I/O 


1 


269 


67 


214 


4508 


18102 


3609 


3 


362 


243 


109 


3350 


4991 


2004 


4 


309 


131 


184 


3925 


9258 


2756 


5 


547 


165 


ISO 


2217 


7350 


1703 


6 


631 


165 


161 


1922 


7350 


1523 


7 








■ 











S 


5843 


2187 


122 


207 


554 


.151 


9 


366 


116 


153 


3313 


10455 


2516 


11 


3501 


1431 


200 


346 


847 


245 


12 




















16 


7158 


2508 


135 


169 


483 


125 
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VOLUME MANAGEMENT METERS 
device meters 



DEVICE_METERS - DISPLAYS SUMMARY OF I/O ACTIVITY FOR ALL DISK 
SUBSYSTEMS 



Total metering time 


0:20:13 










dska 


dskb 


dskc 


dskd 


Prior Page I/O 


18571 


17743 


462 


1273 


ATB 


65.334 


68.383 


2626.240 


953.121 


Other Page I/O 


6525 


5135 


16 


696 


ATB 


185.949 


236.284 


75832.692 


1743.280 


ATB Page I/O 


48.347 


53.034 


2538.332 


616.212 


Prior VTOCE I/O 


934 


895 


38 


304 


ATB 


1299.061 


1355.668 


31929.554 


3991.194 


ATB I/O 


46.612 


51.037 


2351.401 


533.798 


% Busy 


76 


74 





4 


Avg, Page Wait 


47.289 


46.197 


20.341 


24.666 


Avg. Page '^Wait 


176.082 


101.023 


36.996 


61.704 


Avg VTOCE Wait 


41.138 


37.610 


38.595 


29.090 


Avg. Page I/O T 


35.619 


38.314 


20.050 


22.482 


Avg. VTOCE I/O T 


31.139 


32.277 


37.060 


26.606 


F.DAC Corr. Errs 














Errors 











1 


Fatal Errors 
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VOLUME MANAGEMENT METERS 



disk queue 



fi DISK_QDEUE - DISPLAYS I/O QUEUE FOR A DISK SUBSYSTEM 
ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 



Connects = 2604781, 1359725, 677321, 309367, 
123430, 40159, 10227, 1969. 

P RW VP DV SECTOR MEM 

W P 24 1350330 27304000 

W P 9 1020150 4432000 

W P 16 1204130 36246000 

W P 16 314370 27306000 

W P 16 314430 34166000 



Not To Be Reproduced 6-45 F80A 

(End Of Topic) 



TOPIC VII 
Segment Control 
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dump_vtoce 7- .8 
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SEGMENT CONTROL OVERVIEW 



B FUNCTION 



SEGMENT CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF LOGICAL 
MEMORY 



ITS TASKS INCLUDE: 

MAINTAINING THE DISK RESIDENT MAPS OF SEGMENTS (IE: THEIR 
VTOCE ' S ) 

1 SEGMENT CREATION, TRUNCATION AND DELETION 

I SEGMENT ACTIVATION AND DEACTIVATION (ASTE MULTI PLEZI NG ) 



SEGMENT CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
SEGMENT FAULTS 



B BASIC PHILOSOPHY OF ACTIVATION/DEACTIVATION 



I OF ALL SEGMENTS RESIDENT WITHIN THE SYSTEM'S MOUNTED PHYSICAL 
VOLUMES, ONLY A SMALL SUBSET WILL REQUIRE ACCESSING AT ANY ONE 
TIME, SUCH SEGMENTS WILL BE CALLED "ACTIVE SEGMENTS" 



D A PART OF MAIN MEMORY, CALLED THE "ACTIVE SEGMENT TABLE" (AST), 
WILL BE RESERVED TO HOLD MANAGEMENT INFORMATION FOR THESE ACTIVE 
SEGMENTS (IDENTITY, PVT INDEX, LOCATION OF PAGES, ETC.) 
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SEGMENT CONTROL OVERVIEW 



AS SEGMENTS FALL INTO DISUSE, THEIR "MANAGEMENT INFORMATION" IN 
THE AST WILL BE REPLACED WITH INFORMATION OF OTHER SEGMENTS 
REQUIRING ACTIVATION 



B USER INTERFACE 

COMMAND LEVEL 

I create, delete, truncate, etc.' 

5 SUBROUTINE LEVEL 

I hcs_$append_branch, hcs_$append_branchx, hcs_$delentry_seg, 
hcs_$delentry_f ile, hcs_struncate_seg, hcs_$truncate_f ile , 
hcs_$f orce_write , etc 



B MAJOR DATA BASES 

D SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM, SHARED WITH PAGE 
CONTROL. ONE MAJOR COMPONENT IS "OWNED" BY SEGMENT CONTROL: 

O ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 

D THE AST IS A LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 

D ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 

I ASTES CONTAIN PHYSICAL VOLUME ID'S (PVID'S) AND VTOC 
INDEX'S (VTOCX'S) OF SEGMENTS. NEEDED BY SEGMENT CONTROL 
TO FIND THE SEGMENT ON DISK (HARDWARE) 
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SEGMENT CONTROL OVERVIEW 

AST HASH TABLE 

J ALLOWS EFFICIENT SEARCHING OF ASTE'S 

I LOGICALLY PART OF THE AST, BUT ELSEWHERE FOR HISTORICAL 
REASONS 

B DIRECTORY SEGMENTS 

O CONTAIN LOCATIONS AND ATTRIBUTES OF SEGMENTS. LOCATION 
INFORMATION FROM DIRECTORY SEGMENTS IS PROVIDED TO SEGMENT 
CONTROL BY DIRECTORY CONTROL 

D VOLUME TABLE OF CONTENTS (VTOC) - ONE PER PHYSICAL VOLUME 

VOLUME TABLE OF CONTENTS ENTRY (VTOCE) - ONE PER 
DISK-RESIDENT SEGMENT 



EACH VTOCE CONTAINS THE SEGMENT'S UNIQUE ID, CURRENT LENGTH, 
FILE MAP, ETC (NEED TO BUILD ASTE'S AND PT'S) 



VTOCES ARE READ AND WRITTEN ONLY BY SEGMENT CONTROL 

VTOCE STOCKS - FROM VOLUME MANAGEMENT 

II USED WHEN CREATING AND DELETING VTOCES FOR SEGMENTS 
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SEGMENT CONTROL TERMINOLOGY 



MULTIPLEXING: CONTROLLED SHARING OF A REUSABLE RESOURCE 



VTOC: 



VOLUME TABLE OF CONTENTS (ONE PER PV) . AN ARRAY OF 
VTOCE'S IDENTIFYING ALL SEGMENTS RESIDENT ON THE 
PHYSICAL VOLUME 



VTOCE : 



VOLUME TABLE OF CONTENTS ENTRY (ONE PER RESIDENT 

SEGMENT). CONTAINS IDENTIFICATION AND LOCATOR 

INFORMATION ABOUT A SEGMENT RESIDENT WITHIN THE 
PHYSICAL VOLUME 



SEGMENT : 



A COLLECTION OF INFORMATION (PROCEDURE OR DATA) GROUPED 
TOGETHER UNDER THE SAME ACCESS CONTROL CONSTRAINTS. 
EACH SEGMENT IS GIVEN ONE OR MORE NAMES AND A 
COLLECTION OF ATTRIBUTES INCLUDING LENGTH, ACCESS 
PERMISSIONS, ETC 



SEMI -PERMANENT 



ACTIVATISS: A SEGMENT AND TURNING ON ITS ENTRY HOLD 
SWITCH (aste.ehs) PREVENTING NORMAL (ASTE CONTENTION) 
DEACTIVATION 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC ) 



J,, .P f^- ^^^^ ^""^^- 



1I111I1111222222222 >/3 3 3 3 3 3 
0123J5ST3901234S8;89Q1Z3JSS7 8/^ ! 2 3 i 5 



SEGMENT'S UNICMJE lOENTIFlEa (UIO) 



MAX LENGTH 



CURRENT LENGTH 



RECORDS USED 






DATE TIME USES (OTU) 





n 


N 


n 


S 


P 


D 


F 


F 


s 


n 


F 


1 


n 


T 


P 


A 


M 


V 




^ 


r 





7 


P 




M 





c 


N 


Vf 






















DATE TIME MODIFIED (OTMI 



FILE MAP CHECKSUM 



10 WORDS OF aUOTA RELEVANT INFORMATION TO INCLUDE 
THE TIME-RECORD PRODUCT AND USAGE COUNT 



FILE MAP 101 



FILE MAP (941 



FILE MAP (1) 



FILE MAP (35) 



FILE MAP (9Si 



FILE MAP (37! 



FILE MAP (222) 



FILE MAP (2231 



FILE MAP (2241 



RLE MAP (225) 



FILE MAP (2541 



FILE MAP (2551 



10 WORDS NOT USED 






i 1 






2 C f-^i- "^ . 



••3 = 
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SEGMENT CONTROL DATA BASES 
VOLUME TABLE OF CONTENTS (VTOC) 



SESMENT CONTROL, DATA BASES 
VOLUME TABLE OF CONTENTS VTOCE 



155 
156 
157 
15S 
1S9 



cr 
or" 






DATE TIME DUMPED (DTOI 



VOLUME iO (II 



IINCREMENTAL DUMP TAPE 101 



VOLUME ID (21 



ICONSOLIOATED DUMP TAPE 101 



VOLIME ID (31 



(COMPLETE DUMP TAPE 101 



UIO OF MASTER OIAECTORY 



UID OF SUPERIOR DIRECTORY (01 



UID OF SUPERIOR DIRECTORY (151 



3 WORDS CONTAINING THE SEGMENT'S 
ORIGINAL PRIMARY NAME 



:1 1 



DATE_TIME VTOCE CREATED 



PVID OF VOLUME OF PARENT DIRECTORY 



PARENT VTOC INDEX 



SEGMENT BRANCH OFFSET IN PARENT 



187 
1S8 



TIME THIS VTOCE CHECKED FOR CONNECTION FAILURE 



ACCESS ISOLATION MECHANISM (AIMI CLASS 



PVIO OF VOLUME FOR THIS VTOCE 



(WORDS) 



ivtocejnci.plll 



VOLUME TABLE OF CONTENTS ENTRY (VTOCE) 

A DISK RESIDENT DATA BASE - ONE PER SEGMENT 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC) 



B THE "VOLUME TABLE OF CONTENTS" (VTOC) IS A DISK RESIDENT DATA BASE 
CONTAINING (OF INTEREST HERE) AN, ARRAY OF ENTRIES KNOWN AS "VOLUME 
TABLE OF CONTENTS ENTRIES" (VTOCE'S) 



ONE VTOC PER PHYSICAL VOLUME 



I ONE VTOCE PER SEGMENT 



s EACH VTOCE CONTAINS RESIDENCY INFORMATION (AND SOME ATTRIBUTE 
INFORMATION) OF A PARTICULAR SEGMENT 



B EACH VTOCE IS ADDRESSED BY INDEZING INTO THE ARRAY OF VTOCE'S 



D CONSEQUENTLY, THS;- PAIR OF PVID AND VTOC INDEX UNIQUELY 
IDENTIFIES ANY SEGMENT IN THE STORAGE SYSTEM HIERARCHY 



EACH VTOCE IS 192 WORDS LONG AND IS DIVIDED INTO THREE LOGICAL 
PARTS : 



D ACTIVATION INFORMATION (16 WORDS) 



CONTAINS ALL INFORMATION (EXCLUDING THE FILE MAP) NEEDED TO 
USE THE SEGMENT, OR MORE TECHNICALLY, TO ACTIVATE THE SEGMENT 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC") 



I INCLUDES: UID, CURRENT LENGTH, RECORDS USED, MAXIMUM 
LENGTH, RECORDS USED, ETC 

B ALL INFORMATION LIKELY TO CHANGE BECAUSE OF THE ACTIVATION 

D INCLUDES: DATE TIME MODIFIED AND USED, QUOTA CELLS (IF A 
DIRECTORY), ETC 



FILE MAP (128 WORDS) 

AN ARRAY OF 256 RECORD ADDRESS OR NULL ADDRESS DETAILING 
WHERE EACH PAGE OF THE SEGMENT RESIDES 



J A NULL ADDRESS (NOT TO BE CONFUSED WITH A NULLED ADDRESS -- 
DISCUSSED LATER) INDICATES THAT NO RECORD OF THE VOLUME IS 
ASSIGNED TO. THAT PAGE OF THE SEGMENT 



A RECORD ADDRESS IS THE ADDRESS OF THE RECORD ASSIGNED TO 
THAT PAGE OF THE SEGMENT (I.E., THE DISK RESIDENT HOME OF THE 
PAGE ) 



1 NOTE: PAGE CONTROL ENSURES THAT NO RECORD ADDRESS EVER 
APPEARS (OR REMAINS) IN THE FILE MAP UNLESS THE PAGE ACTUALLY 
APPEARS ON THE VOLUME 



I PERMANENT INFORMATION (48 WORDS) 

D CONTAINS ATTRIBUTES WHICH RARELY (IF EVER) CHANGE SUCH AS: 

I UID'S OF SUPERIOR DIRECTORIES, AIM CLASSIFICATION, DAT; 
TIME. DUMPED (BY PHYSICAL VOLUME DUMPER) 
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SEGMENT CONTROL DATA BASES 
VOLUME TABLE OF CONTENTS (VTOC) 



8 EACH VTOCE IS ALSO DIVIDED INTO THREE PHYSICAL PARTS: 



I FIRST SECTOR (WORDS 0-63): 

8 CONTAINS ALL "ACTIVATION INFORMATION" AND THE FIRST PORTION 
OF THE FILE MAP 



SECOND SECTOR (WORDS 64-127): 

J CONTAINS THE BULK OF THE FILE MAP 

THIRD SECTOR (WORDS 128-191): 

J CONTAINS THE END OF THE FILE MAP AND ALL "PERMANENT 
INFORMATION" 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC) 



B VTOCE I/O 



USING RECORD I/O (IN UNITS OF 1024 WORDS) TO ACCESS A VTOCE (192 
WORDS) WOULD HAVE EXCESSIVE OVERHEAD FOR BUFFERS 



FURTHERMORE, BECAUSE MOST SEGMENTS ARE SMALL, MOST VTOCE 
ACCESSING IS ONLY CONCERNED WITH ACTIVATION INFORMATION AND THE 
FIRST PORTION OF THE FILE MAP, I.E., THE FIRST SECTOR (64 WORDS) 



TO TAKE ADVANTAGE OF THESE FACTS, VTOCE 'S ARE ACCESSED VIA 
SECTOR I/O, NOT RECORD I/O 



A LARGE MECHANISM KNOWN AS THE VTOC MANAGER (vtoc_inan) EXIST TO 
EFFICIENTLY MANAGE THIS SECTOR I/O AND ITS BUFFERING 



VTOCE I/O IS THE ONLY NON-PAGE I/O DONE TO DISK 



1 VTOCE I/O IS DONE IN PARTS (SECTORS) 

I FOR A SEGMENT, OR A DIRECTORY WITHOUT TERMINAL QUOTA, PARTS 
ONE AND TWO CAN 3E WRITTEN ENTIRELY FROM INFORMATION DERIVED 
FROM THE ASTE, AND NEED NOT BE READ IN FIRST 

1 PART THREE MUST ALWAYS BE READ BEFORE BEING WRITTEN, AS MUST 
PART ONE FOR A DIRECTORY WITH QUOTA 

ALL THREE PARTS OF A VTOCE ARE ALWAYS READ WHENEVER ANY PART 
IS REQUESTED, IN CASE THE OTHERS ARE NEEDED SOON AFTERWARDS 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



THE ACTIVE SEGMENT TABLE (AST) IS A HARDCORE, WIRED, UNPAGED, DATA 
BASE LOCATED WITHIN THE SYSTEM SEGMENT TABLE (SST), AND CONSISTS OF 
AN ARRAY OF PAIRED ENTRIES KNOWN AS ACTIVE SEGMENT TABLE ENTRIES 
(ASTE'S) AND PAGE TABLES (PT'S) 



ONE AST PER SYSTEM 



ONE ASTE/PT PAIR PER ACTIVE SEGMENT 



IN ORDER FOR A SEGMENT TO BE ACCESSED VIA THE HARDWARE, VTOCE 
INFORMATION MUST BE BROUGHT INTO MAIN MEMORY 



B THE 12 WORD ASTE (AND ITS ASSOCIATED PAGE TABLE) CAN BE THOUGHT OF 
AS THE MAIN MEMORY RESIDENT IMAGE OF THE VTOCE 



I SPECIFICALLY, THE ASTE CONTAINS: 

I THE VTOCE' S "ACTIVATION INFORMATION" SUCH AS THE SEGMENTS 
UID, CURRENT LENGTH, MAX LENGTH, DTU, DTM, QUOTA DATA 

B AND NON-VTOCE INFORMATION SUCH AS: PVT INDEX, VTOC INDEX, 
VARIOUS FLAGS AND POINTERS 



THE PAGE TABLE CONTAINS THE RECORD ADDRESS (TAKEN FROM THE 
VTOCE' S "FILE MAP") OF EACH NONZERO PAGE OF THE SEGMENT 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



B A SEGMENT HAVING AN ASTE AND A PAGE TABLE IS SAID TO BE ACTIVE 



"ACTIVATING" A SEGMENT IS THE PROCESS OF ALLOCATING (AND FILLING 
IN) AN ASTE AND A PAGE TABLE FOR THE SEGMENT 



CONVERSELY, "DEACTIVATING" A SEGMENT INVOLVES FREEING ITS ASTE 
AND PAGE TABLE FOR FURTHER USE 



I BEING ACTIVE DOES NOT IMPLY THAT THE SEGMENT IS ACTUALLY IN USE 
BY ANY PROCESS 



B SINCE THE AST IS A PART OF A SINGLE SEGMENT (HAVING FINITE SIZE), 



J ONLY A FINITE NUMBER OF SEGMENTS MAY BE ACTIVE AT ONE TIME 



WHEN A NON-ACTIVE SEGMENT IS REFERENCED, AND THERE ARE NO FREE 
ASTE'S AVAILABLE, SOME SEGMENT MUST BE DEACTIVATED 



THIS ASTE/PT .MULTIPLEXING IS THE PRIME RESPONSIBILITY OF 
SEGMENT CONTROL 



BEING A FINITE (AND A CRITICAL) SYSTEM RESOURCE, THE NUMBER OF 
ASTE/PT PAIRS CAN DRAMATICALLY AFFECT THE COMPETITION FOR 
ASTE'S, AND CONSEQUENTLY SYSTEM PERFORMANCE 
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SEGMENT CONTROL DATA BASES 
ACTIVE SEGMENT TABLE (AST) 



B TOO FEW ASTE/PT PAIRS WILL CAUSE "SEGMENT THRASHING" 

TOO MANY ASTE/PT PAIRS WILL OCCUPY MAIN MEMORY FRAMES THAT 
MIGHT BETTER BE UTILIZED FOR NORMAL PAGING TRAFFIC, PERHAPS 
LEADING TO "PAGE THRASHING" 

CONSEQUENTLY, THE NUMBER OF ASTE/PT PAIRS IS A CRITICAL 
SYSTEM PARAMETER (SET ON THE SST CONFIG CARD) 

O OF THE TWO POSSIBILITIES, TOO MANY OR TOO FEW, TOO FEW IS 
BY FAR THE WORSE 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST; 



IN ORDER TO MAXIMIZE THE NUMBER OF ASTE/PT PAIRS WITHIN AN AST OF A 
GIVEN SIZE, ASTS/PT PAIRS COME IN FOUR FIXED SIZES: 



B ASTE + A 4 WORD PAGE TABLE (16 WORDS TOTAL) 
0" FOR 0-4K SEGMENTS 

1 ASTE + A 16 WORD PAGE TABLE (28 WORDS TOTAL) 
[ FOR 5-16K SEGMENTS 

J ASTE + A 64 WORD PAGE TABLE (76 WORDS TOTAL) 
I FOR 17-64 K SEGMENTS 

jj ASTE -i- A 256 WORD PAGE TABLE (263 WORDS TOTAL) 
I FOR 65-256K SEGMENTS 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



THE SIZE OF EACH OF THE FOUR ASTE POOLS IS DETERMINED AT SYSTEM 
IIjIITIALIZATION BY THE SST CONFIG CARD AND IS A CRITICAL SYSTEM 
TUNING PARAMETER 



SINCE THE FREQUENCY OF SMALL SEGMENTS IS HIGHER THAN THE FREQUENCY 
OF LARGE SEGMENTS, THE DISTRIBUTION OF ASTE'S IS NORMALLY AS 
FOLLOWS ; 



4K > 15K > 64K > 256K 



ON SYSTEM-M, IN PHOENIX, A 6 CPU, 8MW MEMORY, 2 00 USER SYSTEM, 
THE ASTE DISTRIBUTION IS NORMALLY: 

3500 1500 750 250 

ON MIT-MULTICS, A 3 CPU, 3 . 5MW MEMORY, 110 USER SYSTEM, THE ASTE 
DISTRIBUTION IS NORMALLY: 

i7nn finn ?:?n 7R 



A SEGMENT NORMALLY REMAINS ACTIVE (FOR >200 SECONDS) UNTIL FORCED 
TO GIVE UP ITS ASTE/PT PAIR TO ANOTHER SEGMENT (DEACTIVATION) 
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SEGMENT CONTROL DATA BASES 
ACTIVE SEGMENT TABLE (AST) 

8 THIS DEACTIVATION CONSISTS OF: 

i MAKING THE SEGMENT INACCESSIBLE TO USER PROCESSES 

DONE BY "CUTTING TRAILERS", IN THE PROGRAM setf aults.pll 

fl A LIST OF ALL SEGMENTS CONNECTED TO (USING) THE SEGMENT IS 
KEPT FOR THIS PURPOSE 

8 EVICTING ALL PAGES OF THE SEGMENT FROM MAIN MEMORY 

1 ONLY MODIFIED PAGES MUST BE WRITTEN BACK TO DISK. UNMODIFIED 
PAGES ARE SIMPLY OVERWRITTEN 



UPDATING THE VTOCB BY WRITING THE (POSSIBLY MODIFIED) ACTIVATION 
INFORMATION BACK TO THE VTOCE 



I FREEING THE ASTE/PT PAIR 



SINCE ACTIVATING /DEACTIVATING SEGMENTS IS EXPENSIVE, THE CHOICE OF 
A SEGMENT FOR DEACTIVATION IS IMPORTANT, AND BELONGS TO THE SEGMENT 
REQUIRING ACTIVATION FURTHEST IN THE FUTURE 
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SEGMENT CONTROL DATA BASES 
ACTIVE SEGMENT TABLE (AST) 



THE ALGORITHM WHICH CHOOSES A "BEST" SEGMENT FOR DEACTIVATION IS 
IMPLEMENTED IN THE PROGRAM get_aste, AND CONSIDERS SUCH FACTORS AS: 



B THE PRESENCE OF ACTIVE INFERIORS (IF A DIRECTORY) 



1 THE NUMBER OF PAGES CURRENTLY IN MAIN MEMORY (SINCE WORK IS 
REQUIRED TO EVICT THE MODIFIED FRACTION OF SUCH PAGES AND 
BECAUSE THIS INDICATES "USED RECENTLY" IN SOME SENSE) 



1 IT LOOKS FIRST FOR A SEGMENT WITH NO INFERIORS, AND NO PAGES IN 
MEMORY, AND ALMOST ALWAYS SUCCEEDS - BUT IF IT FAILS, IT TRIES 
TO MAKE A "GOOD CHOICE", AND DEACTIVATES INFERIORS, AND/OR 
FLUSHES PAGES TO DISK IF NECESSARY 
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A DOUBLE THREADED LIST OF SIMILAR OBJECTS GENERALLY IMPLEMENTING 
REPLACEMENT ALGORITHMS. CONTAINS BOTH FREE AND IN-USE OBJECTS, WITH 
FREE OBJECTS MAINTAINED AT THE HEAD OF THE LIST. 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST] 



NOTE: WHILE INSPECTING THE ASTE'S, OPPORTUNITY IS TAKEN TO NOTICE 
ASTE'S WHOSE FILE MAPS HAVE CHANGED AND. TO UPDATE THEIR VTOCE'S 



KNOWN AS "AST TRICKLE" 



D THIS IS DONE TOTALLY AS A HEDGE AGAINST A FATAL CRASH, AS A 
SUCCESSFUL SHUTDOWN UPDATES ALL VTOCE'S OF ACTIVE SEGMENTS 



THIS IS NOT DONE FOR PROCESS DIRECTORY SEGMENTS, SINCE THEIR 
CONTENTS ARE OF LITTLE USE AFTER A CRASH 



THE "AST TRICKLE" IS ALSO FORCED TO OCCUR EVERY FIFTEEN MINUTES 
WHEN THE SYSTEM IS LIGHTLY LOADED, BECAUSE OTHERWISE VTOCES 
MIGHT REMAIN UNUPDATED FOR HOURS 
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SEGMENT CONTROL DATA BASES 
ACTIVE SEGMENT TABLE (AST) 

S AST HIERARCHY 

MIRRORS A SUBSET OF THE STORAGE SYSTEM HIERARCHY 
THE ROOT DIRECTORY (>} CANNOT BE DEACTIVATED 



NO SEGMENT (EZCEPT THE ROOT) MAY BE ACTIVE UNLESS ITS PARENT IS 
ACTIVE. THE REASONS FOR THIS ARE: 



B PARENT MUST BE ACTIVATED IN ORDER TO FIND THE SON 

ACTIVATION OF OTHER SONS IS EASIER IF THE PARENT REMAINS 
ACTIVE 



THE QUOTA ACCOUNT AGAINST' WHICH AN -ACTIVE SEGMENT'S "RECORDS 

USED" IS TALLIED SHOULD BE IMMEDIATELY AVAILABLE WHEN A 
SEGMENT CHANGES SIZE. THE QUOTA ACCOUNT IS FOUND IN ONE OF 
THE ANCESTORS' ASTES 



DATE TIME MODIFIED (DTM) FOR A DIRECTORY IS THE DTM OF THE 
LAST MODIFIED SEGMENT IN THE SUBTREE. DTM OF ALL ANCESTOR'S 
SHOULD BE IMMEDIATELY AVAILABLE WHEN A SEGMENT IS MODIFIED. 
DTM IS FOUND IN THE ASTE OF THE ANCESTORS. (USED BY THE 
HIERARCHY DUMPER) 



SUCH UPDATES TO THE ASTE'S OF PARENTS ARE PERFORMED BY PAGE 
CONTROL 



EACH ASTE HAS A POINTER TO ITS PARENT'S ASTE FOR THE ABOVE 
REASONS. (THIS POINTER IMPLEMENTS THE AST HIERARCHY) 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



ASTE'S MAY BE THREADED ONTO ONE OF SIX LISTS VIA THE RELATIVE 
POINTERS aste.fp and aste.bp 



B FOUR USED LISTS: THREADS ALL FREE AND REPLACEABLE ASTE'S OF 
EACH POOL SIZE ( SSt . level .ausedp POINTS TO' THE FIRST FREE ASTE 
IN THE LIST) 



D INIT AND TEMP LISTS: USED AT SYSTEM INITIALIZATION TO RECEIVE 
(AND DELETE) INITIALIZATION AND TEMPORARY SEGMENTS 



E THERE ALSO EXIST SEVERAL AUXILIARY LISTS SUCH AS THE HASH THREAD 
AND FATHER-SON, AND BROTHERS LISTS. 



ALL ACTIVE SEGMENTS IN THE HIERARCHY ARE IN THE FOUR USED LISTS - 

EXCEPT FOR SEGMENTS IN THE HARDCORE PARTITION (THE PAGED 

SUPERVISOR), AND A SMALL CLASS OF SEGMENTS "WHICH MAY NOT BE 
DEACTIVATED 



SEGMENTS ARE SOMETIMES UNTHREADED FROM THEIR USED LIST 
TEMPORARILY IN ORDER TO KEEP THEM OUT OF REACH WHILE SOME 
COMPLEX OPERATION IS PERFORMED 
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SERVICES OF SEGMENT CONTROL 
CREATING SEGMENTS 



s SEGMENT CREATION IS PERFORMED BY THE PROCEDURE create vtoce 



J INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 



OUTPUT: PVID AND VTOC INDEX OF THE CREATED SEGMENT 



create_vtoce MAY BE CALLED BY append {NORMAL SEGMENT CREATION) OR 
seginent_mover (DUE TO PACK OVERFLOW) 



B PRINCIPAL STEPS OF create_vtoce : 

8 ~ CREATE A LOCAL IMAGE OF THE VTOCE TO BE CREATED 

D FILL IN MOST ACTIVATION AND PERMANENT INFORMATION FROM THE 
BRANCH ENTRY 

B CREATE A NULL FILE MAP 

D DETERMINE THE UID PATH (UID'S OF SUPERIOR DIRECTORIES) 
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SERVICES OF SEGMENT CONTROL 
CREATING SEGMENTS 



SELECT AN APPROPRIATE PV WITHIN THE LV SPECIFIED BY THE 
Sons_lvid OF THE DIRECTORY IN WHICH THE BRANCH ENTRY APPEARS 

SELECTION GOAL IS TO EVENLY DISTRIBUTE SEGMENTS OVER ALL PV'S 
OF THE LV, THEREBY REDUCING DISK CONTENTION 

D SELECTION ALGORITHM WALKS THE CHAIN (THROUGH 
pvte.brother_pvtx) OF PV'S IN THE LV AND SELECTS THE PV 
HAVING THE HIGHEST PERCENTAGE OF UNUSED RECORDS IN ITS PAGING 
REGION 

1] NO PV IS ACCEPTED IF pvte . vacating IS ON, SIGNIFYING THAT 
sweep_pv IS TRYING TO VACATE, OR INHIBIT CREATION UPON, THE 
PV 

1 AN EXCEPTION IS MADE FOR PER PROCESS SEGMENTS 
(entry. per_process IS ON) 

1 SINCE SUCH SEGMENTS ARE ALL HEAVILY USED, A ' ROUND ROBIN 
ALGORITHM EVENLY DISTRIBUTES THESE SEGMENTS ACROSS ALL 
PV'S IN THE LV 



INVOKE THE VTOC MANAGER ( vtoc_man$alloc_and_put_vtoce ) TO 
ALLOCATE AND WRITE THE VTOCE IMAGE ON THE SELECTED PV 

I VTOC_MAN ATTEMPTS TO ALLOCATE A VTOCE FROM THE VTOCE STOCK 
FOR THE VOLUME 

I IF THE STOCK IS EMPTY, IT REFILLS IT FROM THE VTOCE MAP ON 
DISK (SEE vtoce_stock_man.pll) 

I BECAUSE IT IS PERMISSIBLE TO TAKE PAGE FAULTS IN THE 
VTOC_MAN ENVIRONMENT, THE VTOCE STOCK IS ACCESSED WITHOUT 
ANY SPECIAL PAGE CONTROL PROTOCOLS 

I RETURNS THE VTOC INDEX OF THE ALLOCATED VTOCE 
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SERVICES OF SEGMENT CONTROL 
CREATING SEGMENTS 



RETURN THE PVID AND VTOC INDEX OF THE NEW SEGMENT TO THE CALLER 
(WHO RECORDS SAME IN entry. pvid AND entry, vtocx) 
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SERVICES OF SEGMENT CONTROL 



SEGMENT ACTIVATION 



s SEGMENT ACTIVATION IS PERFORMED BY THE PROCEDURE "activate" 



[ INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 



B OUTPUT: AN ASTE POINTER 



B activate IS PRINCIPALLY CALLED BY seg_fault (OF ADDRESS/NAME SPACE 
MANAGEMENT) WHO HAS LOCATED THE SEGMENT'S BRANCH ENTRY, VALIDATED 
THE USER'S ACCESS, AND CHECKED THE PRESENCE OF THE LV 



B PRINCIPAL STEPS OF activate; 



LOCK THE AST LOCK AND CHECK IF THE SEGMENT IS ALRBAJJY ACTlvt. 
IF SO, UNLOCK THE AST AND RETURN ITS ASTE POINTER 



IF THE SEGMENT IS NOT ACTIVE, UNLOCK THE AST AND READ IN ALL 
REQUI'RED PARTS OF THE VTOCE AND COMPARE UID'S FOR CONNECTION 
FAILURE (IN WHICH CASE, DO NOT ACTIVATE AND RETURN AN ERROR) 



1 ENSURE THAT THE SEGMENT'S PARENT IS ACTIVE 



D THIS IS DONE BY REFERENCING THE PARENT DIRECTORY (PERHAPS 
CAUSING A RECURSIVE SEGMENT FAULT AND ACTIVATION) AND SETTING 
THE aste.ehs BIT FOR IT TEMPORARILY WHILE ACTIVATION IS 
TAKING PLACE 
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SERVICES OF SEGMENT CONTROL 



SEGMENT ACTIVATION 



I NOTE THAT THE ONLY EXPLICIT ACTION TAKEN TO ACTIVATE THE 
PARENT IS TO REFERENCE IT; THE POSSIBLE RECURSIVE SEGMENT 
FAULT TAKES CARE OF EVERYTHING AND ALLOWS THAT REFERENCE TO 
PROCEED 



I OBTAIN AN ASTE FOR THE SEGMENT BY CALLING get_aste. THIS MAY 
INVOLVE DEACTIVATING SOME OTHER SEGMENT - BUT HOPEFULLY NOT THE 
PARENT! (ENSURED BY THE aste.ehs BEING ON) 



THREAD THE ASTE INTO THE INFERIOR LIST OF THE PARENT'S ASTE 
(THIS WILL KEEP HIM ACTIVE), AND RESET THE PARENT'S aste.ehs 



FILL IN THE ASTE WITH THE VTOCE'S ACTIVATION INFORMATION AND 
INITIAL FLAG VALUES 



CALL pc$f ill_page_table (PASSING THE VTOCE'S FILE MAP) TO 
INITIALIZE THE PAGE TABLE AND OTHER PAGE CONTROL INFORMATION 



PLACE THE UID IN THE ASTE AND HASH IT INTO THE AST HASH TABLE 



I AFTER A SYSTEM FAILURE, ESD USES A ZERO UID AS A CUE THAT THE 
ASTE IS INVALID, AND DOES NOT INVOKE A VTOCE UPDATE FOR THE 
ASTE 
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SEGMENT TRAILERS 



B WHEN A PROCESS IS USING A SEGMENT, AND IT HAS A VALID SDW FOR THAT 
SEGMENT, A RECORD MUST BE KEPT IN CASE IT IS NECESSARY TO REVOKE 
THAT SDW (WHEN THE SEGMENT IS DELETED, WHEN THE ASTE IS RE-USED, 
ETC) 



B THIS IS DONE BY THE SEGMENT TRAILER MECHANISM 

EACH PROCESS WHICH HAS A VALID SDW FOR A SEGMENT HAS A 
"TRAILER ENTRY" WHICH RECORDS ITS PROCESS IDENTIFICATION AND 
THE SEGMENT NUMBER IT IS USING FOR THE SEGMENT ;>t'''''^\ 

1 TRAILER ENTRIES ARE KEPT IN THE Str_seg, A PAGED SUPERVISOR 
SEGMENT 

B THERE IS A LINKED LIST OF TRAILER ENTRIES FOR EACH SEGMENT; 
THE HEAD IS POINTED TO BY aste.strp 



TRAILERS ARE ONLY KEPT FOR SEGMENTS WHICH MAY BE DEACTIVATED; 
ORDINARY SEGMENTS AND DIRECTORIES, BUT NOT SUPERVISOR SEGMENTS 



A TRAILER IS ATTACHED FOR A SEGMENT BY sea_f ault .pll BEFORE IT. 
PLACES THE SDW INTO THE DSEG FOR THE PROCESS 



TRAILERS ARE USED LATER BY setf aults .pll FOR: 

I DEACTIVATION - THE SDW IS ENTIRELY REVOKED (ZEROED] 



ACCESS CHANGES, DELETION - THE SDW IS MADE INVALID, BUT ITS 
PAGE TABLE ADDRESS IS LEFT UNCHANGED, INDICATING TO 
seg_f ault. pll THAT ALL IT MUST DO IS RECALCULATE THE ACCESS 
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SERVICES OF SEGMENT CONTROL 



SEGMENT TRAILERS 



I PROCESS TERMINATION - ALL SDWS A PROCESS HAD ARE REVOKED AT 
TERMINATION 



J CACHE CONTROL - WHEN THE ENCACHABILITY OF A SEGMENT CHANGES, 
THE SDWS WHICH REFER TO IT MUST HAVE THEIR CACHE CONTROL BITS 
UPDATED 



I TRAILERS. ARE ONLY REMOVED WHEN THE ASSOCIATED SDW IS REVOKED 
COMPLETELY 
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SERVI CSS OF SEGMENT CONTROL 
BOUNDSFAULT HANDLING 



a 



X 
O 

z 

Ui 



III 

QC 
O 



PAGE 



PAGE 1 



PAGE 2 



T 



REFERENCE #1 



REFERENCE #2 



REFERENCE #3 



i PAGE 3 


i PAGE 4 


i PAGE 5 



z 

I- 

io 

lUZ 

II 

X _ 



o 
o 

a. 

I- 

Q. 

UJ 

I- 
W 

< 

a: 



. I 



SEGMENT A 

BOUNDS FAULT HANDLING 

1. PAGE FAULT. PAGE 3 "CREATED" IN MAIN MEMORY 

AS A PAGE OF ZEROS (CAaED A "NEW PAGE") 

2. BOUNDS FAULT. PROMOTE THE SEGMENT TO THE 16K 
ASTE/PT POOL-CONTINUE REFERENCE 

AS IN CASE #1 

3. BOUNDS FAULT. ERROR: SIGNAL "out-of-bounds" 
CONDITION 
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SERVICES OF SEGMENT CONTROL 



BOUNDSFAULT HANDLING 



THE BOUNDSFAULT HANDLER IS THE PROCEDURE "boundsf ault" , INVOKED BY 
THE FAULT INTERCEPTER MODULE, FIM, WHEN THE BOUNDSFAULT IS DETECTED 
BY THE APPENDING UNIT HARDWARE 



s BASIC STEPS OF BOUNDSFAULT 



USING THE SEGMENT NUMBER IN THE (SAVED) MACHINE CONDITIONS, FIND 
AND LOCK THE PARENT DIRECTORY, AND FIND THE BRANCH ENTRY 



LOCK THE AST AND FIND THE SEGMENT'S ASTE VIA 
get_ptrs_$given_segno. IF ATTEMPTED REFERENCE IS BEYOND THE 
MAXIMUM LENGTH (aste.msl) THEN CAUSE ''out_of_bounds" TO BE 
SIGNALLED 



MAKE THE SEGMENT INACCESSIBLE TO USERS BY "CUTTING TRAILERS" 



TURN ON THE PARENT'S a'ste.ehs BIT AND CALL get_aste TO OBTAIN A 
LARGER ASTE 



CALL PAGE CONTROL'S pc$inove_page_table TO MOVE ALL ASTE/PT 
INFORMATION TO THE NEW ASTE 



RETHREAD ALL INFERIOR LIST AND PARENT POINTERS AFFECTED AND TURN 
OFF THE PARENT'S aste.ehs BIT 



NOTE: IF THE SEGMENT IS A DIRECTORY, ALL FATHER POINTERS OF 
INrZRIOR SEGMENTS MUST BE UPDATED 
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SERVICES OF SEGMENT CONTROL 



BOUNDSFAULT HANDLING 



THIS IS THE ONLY REASON FOR THE EXISTENCE OF INFERIOR LIST IN 
THE AST 



J REMOVE THE OLD ASTE FROM THE AST HASH TABLE AND HASH IN THE NEW 

I CALL put_aste TO FREE THE OLD ASTE 

B UNLOCK THE AST AND RETURN A ZERO STATUS CODE TO THE FIM 
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SERVICES OF SEGMENT CONTROL 



SEGMENT DEACTIVATION 



B SEGMENT DEACTIVATION IS PERFORMED BY THE PROCEDURE "deactivate" 



INPUT: POINTER TO AN ASTE 



8 deactivate MAY BE CALLED BY: 



get_aste WHEN AN ASTE MUST BE FREED TO MAKE ROOM FOR A NEW 
SEGMENT 



delete vtoce AS PART OF SEGMENT DELETING 



demount_pv IN ORDER TO UPDATE THE VTOCE 'S (AND SEGMENTS) OF A 
DISK BEING DEMOUNTED 



B PRINCIPAL STEPS OF deactivate: 



MAKE THE SEGMENT INACCESSIBLE TO USERS BY "CUTTING TRAILERS" 



CALL pc$cleanup TO REMOVE ALL PAGES OF THE SEGMENT FROM BULK 
STORE AND MAIN MEMORY, WRITING ALL MODIFIED PAGES TO DISK 
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SERVICES OF SEGMENT CONTROL 
SEGMENT DEACTIVATION 



B UPDATE THE VTOCE FROM THE NOW QUIESCENT ASTE 



THREAD THE ASTE OUT OF PARENT'S INFERIOR LIST, AND OUT OF THE 
AST HASH TABLE 



CALL put_aste TO CLEAR AND INITIALIZE THE ASTE/PT PAIR, AND 
THREAD THE ASTE AT THE HEAD OF THE APPROPRIATE USED LIST 
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SERVICES OF SEGMENT CONTROL 



SUMMARY OF MAJOR SERVICES 



s« 



UN-WIRED 



WIRED 



DATA 



DATA 



LOCATION DATA 

• PVID 

• VTOC INDEX 

VERIFICATION DATA 

• UIO 

• UID OF PARENT 

a DAMAQEO SWITCH 

ACCESS CONTROL DATA 

• RING BRACKETS 

• ACL/AIM 

• COPY/SAFETY SWITCH 
a ENTRY POINT BOUND 

• SECURITY BIT 

ATTRIBUTE DATA 

• NAME(S) 

• AUTHOR 

• BIT COUNT AUTHOR 

• BIT COUNT 

• DIRECTORY BIT 

• PER PROCESS BIT 

• OTEM 





BRANCH ENTRY DATA 




• UID 




• RING BRACKETS 




« COMPUTED ACCESS 




« DIRECTORY BIT 


INITIATION 


■ DTEM 


(niake_knownl 






MAINTAINED DATA 




• SEGMENT NUMBER 




• INITIATED COUNT 




• PRIVILEGED BIT 



SEGMENT FAULT 
(i8g_faultl 



KSTE 



Vj 



BRANCH ENTRY DATA 

• ENTRY POINT BOUND 

KSTE DATA 

• RINGBRAOCETS 

• COMPUTED ACCESS 

• PRIVILEGED BIT 

MAINTAINED DATA 

• ADDR OF PAGE TABLE 
« OUT OF BOUNDS 

• DIRECTED FAULT BIT 
> UNPAGED BIT 

• CACHE BIT 



TERMINATE 
(terminata) 



SOW 



_- 



BRANCH ENTRY 



LIFE CYCLE OF A SEGMENT 



3 3 

4 S 

"-■3 

§1 

o 
m 






BRANCH ENTRY DATA 
■ UID 






ACTIVATION 








(activate) 




• UIO OF PARENT 










• AIM 










• ORIGINAL NAME 

• DIRECTORY BIT 

> PER PROCESS BIT 






DEACTIVATION 








(deactivate) 




• QNZPBIT 










MAINTAINED DATA 

• FILE MAP 

• CURRENT UNGTH 

• RECORDS USED 






AST TRICKLE 








(get_astB) 




■ MAX LENGTH 










• QUOTA DATA 










• USAGE COUNT 

• DTU/DTM/DTC/DTD 

• DUMPER DATA 












(tnincats) 




(pcStruncate) 


• UID PATH 











VTOCE DATA | 




PVTArrOCE INDICES 




UID 




DIRECTORY BIT 




PER PROCESS BIT 




DNZP BIT 




FILE MAP (PT) 




CURRENT LENGTH 




RECORDS USED 




MAX LENGTH 




QUOTA DATA 




USAGE COUNT 




DTU/DTM 


MAINTAINED DATA | 




PHU/PHM BITS 




WIRED BIT 




LISTS R PTR's 




HASH TABLE R PTR 




SYS TRAILER R PTR 




INFERIOR COUNT 




EHS/FMC BITS 




NUMBER OF PAGES 



VTOCE 



ASTE/PT 

r MAINTAINED VTOCE DATA 
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SERVICES OF SEGMENT CONTROL 
TRUNCATING SEGMENTS 



SEGMENT TRUNCATION (IE: PAGE REMOVAL) IS PERFORMED BY THE 
PROCEDURE truncate vtoce 



B INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT, 
AND A PAGE NUMBER FROM WHICH TO START TRUNCATING 



truncate vtoce IS CALLED BY; 



truncate (DIRECTORY CONTROL) WHO HAS LOCATED THE SEGMENTS BRANCH 
ENTRY AND VALIDATED THE USER'S ACCESS 



delete_vtOce (SEGMENT CONTROL) WHO REQUIRES TRUNCATION (FROM 
PAGE #0) PRIOR TO VTOCE DELETION 



B PRINCIPAL STEPS OF truncate vtoce: 



D IF SEGMENT IS ACTIVE, CALL pc$truncate WHO MARKS THE DEVICE 
ADDRESS OF ALL PAGES ABOVE THE PAGE NUMBER SPECIFIED AS "NULLED" 
ADDRESSES (DISCUSSED IN "PAGE CONTROL" TOPIC) 



O IF SEGMENT IS NOT ACTIVE: 

READ IN ALL REQUIRED PARTS OF THE VTOCE AND COMPARE UID'S FOR 
CONNECTION FAILURE (RETURN AN ERROR IF SO) 
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SERVICES OF SEGMENT CONTROL 



TRUNCATING SEGMENTS 



CALL get_pvtx$hold_pvtx TO PREVENT A DEMOUNT (IF CALLED BY 
truncate) 



COPY ALL ADDRESSES OF PAGES TO BE TRUNCATED FROM THE FILE MAP 
AND REPLACE THEM WITH "NULL" ADDRESSES 



B FABRICATE A NEW VTOCE AND WRITE THE VTOCE * BACK BY CALLING 
vtoc_man$put_vtoce 

IF ANY REAL ADDRESSES WERE COPIED FROM THE FILE MAP, AWAIT 
THE SUCCESSFUL COMPLETION OF THE VTOCE WRITE BY CALLING 
vtoc_man$await_vtoce 

i CALL pc$deposit_list TO DEPOSIT (FREE) THESE REAL RECORD 
ADDRESSES 



CALL get_pvtx$release_pvtx TO AGAIN PERMIT DEMOUNTING (IF 
CALLED BY truncate). THIS CREATES AN ENTRY IN THE PV HOLD 
TABLE (SEE TOPIC 6, VOLUME MANAGEMENT) 
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SERVICES OF SEGMENT CONTROL 



DELETING SEGMENTS 



B SEGMENT DELETION IS PERFORMED BY THE PROCEDURE delete vtoce 



INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 



delete_vtoce IS CALLED BY delentry (OF DIRECTORY CONTROL FAME) WHO 
HAS LOCATED THE SEGMENT'S BRANCH ENTRY AND VALIDATED THE USER'S 
ACCESS 



PRINCIPAL STEPS OF delete vtoce; 



J CALL get_DVtx$hold_pvtx TO .PREVENT A VOLUME DEMOUNT IN THE 
MIDDLE OF THE DELETION 



B IF ACTIVE, MAKE THE SEGMENT INACCESSIBLE TO USERS (SEE "ADDRESS 
AND NAME SPACE MANAGEMENT" , TOPIC 5) 



[] TRUNCATE THE SEGMENT TO ZERO LENGTH (SEE "TRUNCATING SEGMENTS" 
IN THIS TOPIC), FREEING ALL DISK, BULK STORE, AND MAIN MEMORY 
PAGES OCCUPIED BY THE SEGMENT 



O IF THE SEGMENT IS A DIRECTORY SEGMENT HAVING A QUOTA ACCOUNT, 
CALL THE QUOTA MOVE PRIMITIVE (guotaw$inq) TO RELINQUISH THE 
QUOTA TO ITS SUPERIOR 
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SERVICES OF SEGMENT CONTROL 



DELETING SEGMENTS 



B NOTE: DIRECTORY CONTROL IS RESPONSIBLE FOR DELETING ALL 
INFERIOR SEGMENTS BEFORE REQUESTING DELETION OF THE DIRECTORY 
- ENSURING A CONSISTENT HIERARCHY AND RECOVERY OF ALL 
INFERIOR QUOTA ACCOUNTS 



I IF THE .SEGMENT IS ACTIVE, DEACTIVATE IT, RELEASING ITS ASTE 

S FREE THE VTOCE WITH A CALL TO vtoc_man$f ree_vtoce 

B CALL get_pvtx$release_pvtx TO AGAIN PERMIT VOLUME DEMOUNTING 
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SERVICES OF SEGMENT CONTROL 



OTHER SERVICES 



s OTHER SERVICES PERFORMED BY SEGMENT CONTROL INCLUDE: 



SEGMENT MOVING 



REQUIRED WHEN AN ATTEMPT IS MADE TO GROW A SEGMENT AND THERE 
IS NO MORE ROOM ON THE PHYSICAL VOLUME 



THE ENTIRE SEGMENT MUST BE MOVED TO ANOTHER PV WITHIN THE 
SAME LV TRANSPARENT TO THE USER AND DIRECTORY CONTROL 



THIS IS THE SINGLE MOST INVOLVED AND ESOTERIC SERVICE OF 
SEGMENT CONTROL 



J SEMI -PERMANENT ACTIVATION 

D ACTIVATING A SEGMENT INTO AN ASTE OF A GIVEN SIZE AND TURNING 
ON ITS aste.ehs (DONE BY grab_aste) 



SERVICES FOR sweep_pv 

LISTING THE VTOC OF A PACK (IE: REPORTING THE PATHNAMES OF 
ALL SEGMENTS OWNING VTOCE'S) 

O THE LOCATING AND DELETING OF ORPHAN VTOCE ' S (VTOCE'S NOT 
DESCRIBED IN ANY BRANCH) 

[ REBALANCING OR VACATING PACKS VIA DEMAND SEGMENT MOVING 
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SERVICES OF SEGMENT CONTROL 



OTHER SERVICES 



S SERVICES AT DEMOUNT/SHUTDOWN TIME 

I -DEACTIVATION OF ALL SEGMENTS ON THE VOLUME BEING DEMOUNTED 
AND WRITING OUT THE LABEL, ETC 



SERVICES FOR ADDRESS/NAME SPACE MANAGEMENT (SEE TOPIC 4) 

I DESCRIPTOR SEGMENT (DSEG) , PROCESS DATA SEGMENT (PDS) AND 
KNOWN SEGMENT TABLE (KST) MANAGEMENT 

J SEGMENT FAULT HANDLING (seg_fault), CREATION, ENTRY HOLDING 
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SEGWEKT CONTROL METERS 
file system meters 

fILE SYS-£f,_nLTER£ - D'SPL&YS MISCELLANEOUS METERING IN^ORMA^'ON 
FOR THE F ILE SYSTEM 



I ONLY PARTS RELEVANT TO SEGMENT CONTROL INCLUDED HERE; SEE TOPIC 
8 (PAGE CONTROL) FOR THE REST 



Total metering time 0:20:02 








# 






Act i vat i ons 


1043 


1.153 


sec. 






secf aul t 


969 


1.241 


sec. 


92.905% of 


all 


makeknown 


74 


16.251 


sec. 


7.095^ of 


£i 1 


di rector ies 


96 


12.527 


sec. 


9.204?. of 


ai \ 


Dead i vat i ons 


1056 


1.139 


sec. 






Derriand deactivate 












attempts 


3 


400.557 


sec. 






Seg Faults 


5080 


0.237 


sec. 






f aui t 


4311 


0.279 


sec . 


84.862% of 


Seg Faults 


call 


769 


1-564 


sec . 


15.138% 0^ 


Seg Fac'ts 


act i vat ions 


969 


1.241 


sec. 


15.075% o^ 


Sec Fajlts 


Bound Faults 


220 


5.466 


sec. 






r e 1 


1 1 C J 


ICO 1Q 1 


me o** . 






oet 1 sL 1 ts 


HHO^ 


4.UU • • ^ * 








access 


42 


28.633 


sec. 


0.937% of 


setf ajl ts 


ASTE Trickle 


139 


8.652 


sec. 






Steps 


4279 


281.040 


msec. 






Skips 


3016 


C.399 


sec . 


7G.uB4% of 


Steps 


ehs~.>«<t-\XAV SC-'^'-V 


271 


U.43B 


sec . 


E.9E5% 0-' 


Sk i ps 


mem \v> i^-^-- f-'-^ 


1083 


1.110 


sec . 


35.909% DT- 


Sk i PS 


i ni t 


1662 


0.724 


sec . 


55. ;06% of 


Sk i ps 


Searches 





0.000 


sec. 






Cleanups 




1056 


1.139 


sec. 0.1 


% of real 


Force wr i tes 


3 


400.857 


sec. 






pages written . 


3 


400.857 


sec. 






Lock AST 


18422 


0.065 


sec. 







g^liKA, _ Cleanups 1056 1.139 sec. 0.1 % of real time 
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AST locked 

AST lock waiting 



AST Sizes 

Number 

Need 

Steps 

Ave Steps 

Lap Time (sec) 



file system meters 



X'^'^ 



ft'^ 



J:Sk PeV( 



$ h-e-^'K 



AVE/1 ock 
4.833 msec. 
1.601 msec. 



y 




4 

1701 
819 

2341 
2.9^ 



fl'\< 



3-^^ 



16 
601 
202 
645 
3.2 



873. BL 1120.5 



2.5 -'V ^^"^ 

64 
■ 221 

208 

1133 

5.5 

233.3 



fk.J .^? < J ''sd 



■J> 



256 

74 

34 

154 

4.5 

577.9 



J(. ^§ cxq arou^) Vl/t 



■«" 



5r.5 r^o,T - <e*^ SOv ^mTl ,/^|;p ^;^ ^^^ 



^xP^ ^T 



w_^ ^ ^ 



SQ\j 



or 







:5^Sp?^.-(^— 






^S\] 



1>N 



°°^^^ n f.o>. 3 



D 



'^^y eon 






!.-->l,7- l©/t4, Ur/ <?/::■ n, aA(?r/ ., / ^ ^""^ yi l^^ 
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S£G.".ENT CONTROL HETERS 
vtoc buffer meters 

e VTOC BUi^FER METERS - DISPLAYS VTOC BUFFER MANAGER ACTIVITY 



Toia' metering time: 
Rout i ne 



Disk I /Os 



Reads 

Wr i les 



65:21:12 
# cal Is ATB(sec) 



get_vtoce 


13i»6752 


0.17 


put_vt6ce 





0.00 


a] loc_3nc_Dut_vtoce 


77378 


3.01* 


f ree_vioce 


75oi>h 


3.11 


awai t_vtoce 


93370 


2.52 


GET_b'ijFFERS 


2732265 


0.09 1656952 Hits 


WAIT 


Si*6i.37 


0.25 9i*6i,35 TC Waits 


Buff e- Al locat iop 








#■ ATB 


(sec) 


Steps 


135i279 


C.17 


Sk i ps 


278366 


O.Bi4 20.6:% of steps 


OE 


2LC3i*B 


0-98 86-2% of skips 


— I^Ct 


^ 


0.00 0.0% cf skips 


wa i t 


385:8 


6.11 13.5^ of skips 



( 60.6% of cal Is) 



# A-B(5ec; 



e369U 
51^8573 



0.28 
o.i43 
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SEGMENT CONTROL COMMANDS 



print aste ptp 
PRINT ASTE PTP - DISPLAYS INFORMATION FROM AN ASTE 



ASTE for >udd>Multics>Sibert at 115244 in sst_seg 
077550100664 041540056140 165706076310 102401170050 
315015000063 640000044000 446736250032 446736250272 
003720000000 003164000110 006200006000 073770000102 

uid = 102401170050, vtocx = 63 on pvtx 15 (root4 = dskd_13) 

max len 205, 6 recs used, in core, cur len 6 (decimalj 

Used 03/18/83 0116.0 est Fri 

Modified 03/18/83 0116.2 est Fri 

Par astep = 76310, Son - 56140, brother = 41540 

Trailer thread = 165706 

Aste for a directory. 

Quota (S D) = (2000 0) 

QUsed (S D) = (1652 72) 

Flags: usedf init seg-tqsw fms 
PAGE PT . DEVADD 

063540200041 63540 

1 063546200041 63546 

2 063547200041 63547 

3 063550200041 63550 

4 063567200041 63567 

5 063571200041 63571 

6 377020000001 null 

17 377020000001 null 
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SEGMENT CONTROL COMMANDS 
dump vtoce 

B DUMP_VTOCE - READS A VTOCE FROM DISK AND DISPLAYS ITS CONTENTS 

vtoce Sibert (Directory), vtocx 63 on pvtx 15 {root4)-03/l8/83 0116.7 est Fri 

Uid = 102401170050, msl/csl/rec = 205 ^ ^ 

Quota (S D) = (2000 0) 

Quota used (S D) = (1423 44) 

Quota received (S D) = (2000 0) 

Created 08/16/81 1204.0 est Sun 

Dumped 03/18/83 0106.7 est Fri 

Used 03/17/83 1737.8 est Thu 

Modified 03/15/83 2138.3 est Tue 

Switches: fm_checksum_valid 

Activation information: 

000000000000 102401170050 315006006000 446734564570 

4 446723404647 001000400000 063560063567 003720000000 

10 002617000054 003720000000 000000000000 015364402005 

14 000000000000 000652154327 446734634556 445673737671 

File map: 

20 063540063546 063547063550 063567063571 777020777020 
24 777020777020 777020777020 777020777020 777020777020 
30 777776777776 777776777776 777776777776 777776777776 



214 777776777776 777776777776 777776777776 777776777776 
Permanent information: 
220 000000000000 000000000000 000000000000 000000000000 



230 000000000000 000000000000 000000000000 446736227316 

234 126104000547 126104000525 126104000764 000000000000 

240 777777777777 033022237767 033023254650 000000000000 

244 000000000000 000000000000 000000000000 000000000000 



260 123151142145 162164040040 040040040040 040040040040 

264 040040040040 040040040040 040040040040 040040040040 

270 441200557477 135240026001 004370027106 000000000000 

274 000000000000 000000000000 000000000000 000000000000 
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TOPIC VIII 
Page Control 



Page 

Page Control Overview 8-1 

Page Control Terminology 8-5 

Page Control Data Bases 8-6 

Page Tables 8-6 

Core Map 8-9 

System Segment Table (SST) Header 8-11 

Other Data Bases 8-13 

Services of Page Control 8-15 

Page Fault Handling 8-15 

Post Purging 8-27 

Page Control Meters. ........... 8-28 

f ile_system_meters . . ........... 8-28 
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PAGE CONTROL OVERVIEW 



B FUNCTION 



I PAGE CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
MEMORY TO INCLUDE THE MULTIPLEXING OF MAIN MEMORY FRAMES, AND 
THE MANAGEMENT OF DISK STORAGE 



O ITS TASKS INCLUDE: 

B TRANSFERRING THE PAGES OF SEGMENTS BETWEEN THE MEMORY 
DEVICES, AND RECORDING THE LOCATION OF "THE" COPY OF THESE 
PAGES 

REPORTING THE STATUS AND FILE MAPS OF SEGMENTS TO SEGMENT 
CONTROL 



D PAGE CONTROL IS LARGELY CODED IN MULTICS ASSEMBLER LANGUAGE 
(ALM) 



B PAGE CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
PAGE FAULTS 



B THERE ARE -NO EXPLICIT USER INTERFACES TO PAGE CONTROL 
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PAGE CONTROL OVERVIEW 



B BASIC PHILOSOPHY 



g OF ALL THE SEGMENTS ACTI^/E AT A GIVEN TIME, ONLY A SMALL SUBSET 
OF THEIR TOTAL PAGES WILL BE REQUIRED FOR ACCESSING 



PAGES WILL BE READ INTO MAIN MEMORY AS THEY ARE REQUIRED 



J THE READING OF A PAGE INTO MAIN MEMORY WILL (PROBABLY) REQUIRE 
THE EVICTION OF A PREVIOUSLY REQUIRED PAGE 



I THE CHOICE OF A PAGE FOR EVICTION WILL BE BASED ESSENTIALLY UPON 
A "LEAST RECENTLY USED" CRITERIA 



AN EVICTED PAGE NEED BE WRITTEN BACK TO DISK ONLY IF IT WAS 
MODIFIED DURING ITS RESIDENCY IN MAIN MEMORY 



B MiAJOR DATA BASES 



PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM. PROVIDED 3Y 
VOLUME MANAGEMENT 



PHYSICAL VOLUME TABLE ENTRY { PVTE ) - ONE PER DISK DRIVE 
CONFIGURED 



O THE DEVICE ID (DISK DRIVE ID) AND THE ID OF THE PHYSICAI 
VOLUME (DISK PACK) CURRENTLY MOUNTED 
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PAGE CONTROL OVERVIEW 



I THE NUMBER OF RECORDS LEFT UNALLOCATED ON THE PHYSICAL 
VOLUME, POINTER TO THE RECORD STOCK, ETC 



RECORD STOCKS - ONE PER MOUNTED PHYSICAL VOLUME, PROVIDED BY 
VOLUME MANAGEMENT 



CONTAINS AN IN-MEMORY CACHE OF THE .IN-USE STATUS OF RECORDg 
ON THE VOLUME, FROM THE VOLUME MAP, USED V?HEN ALLOCATING OR 
FREEING PAGES 



J ACCESSED BY A COMPLEX MECHANISM WHICH USES NORMAL PAGE I/O 
BUT HAS A PROTOCOL TO ENSURE SYNCHRONIZATION OF DISK CONTENTS 
AND RECORD STOCK CONTENTS 



SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM. SHARED WITH 
SEGMENT CONTROL. CONTAINS THE FOLLOWING FIVE DATA BASES USED BY 
PAGE CONTROL: 



SYSTEM SEGMENT TABLE (SST) HEADER - ONE PER SYSTEM 

n CONTAINS A LARGE NUMBER OF COUNTERS AND POINTERS VITAL TO 
THE MAINTENANCE AND METERING OF THE STORAGE SYSTEM 

CONTAINS LOCKWORDS USED TO SYNCHRONIZE PAGE CONTROL AND 
SEGMENT CONTROL OPERATIONS 



I CORE MAP - THE core_map SEGMENT - ONE PER SYSTEM 

CORE MAP ENTRY (CME) - ONE PER FRAME (1024 WORDS) OF 
CONFIGURED MAIN MEMORY 

EACH CME REPRESENTS A FRAME OF MAIN MEMORY AND IDENTIFIES 
THE CURRENT OCCUPANT OF THAT FRAME 
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PAGE CONTROL OVERVIEW 



NOT PART OF THE SST SEGMENT ANY MORE, BUT LOGICALLY PART 
OF THE SST 



ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 

B ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 
LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 



I PAGE TABLES (PT) - ONE PER ACTIVE SEGMENT, THE OTHER HALF OF 
EACH ASTE 

1 PAGE TABLE WORD (PAGE PTW) - EITHER 4, 16, 64, OR 256 PER 

PAGE TABLE 

D EACH PTW DEFINES THE CURRENT LOCATION OF A PAGE OF THE 
SEGMENT: DISK, MAIN MEMORY ADDRESS, OR NULL 
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PAGE CONTROL TERMINOLOGY 



PAGING: THE PROCESS OF TRANSFERRING PAGES OF DATA BETWEEN DISK 
STORAGE AND MAIN MEMORY (CORE) TO ACHIEVE THE EFFECT OF 
ALL DATA BEING IN MEMORY ALL THE TIME 



CORE: AN OBSOLETE TERM USED FREQUENTLY TO REFER TO MAIN 

MEMORY (WHICH IS MOS TECHNOLOGY, NOT CORE TECHNOLOGY) 



PAGE FAULT: AN EXCEPTION CONDITION DETECTED BY THE PROCESSOR 
HARDWARE (IN THE APPENDING UNIT) WHEN AN ATTEMPT IS 
MADE TO USE A PTW SPECIFYING THAT ITS PAGE IS NOT IN 
MAIN MEMORY 
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PAGE CONTROL DATA BASES 
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NULL ADDRESS - REPRESENTS PAGE OF ZEROES 
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A 15K PAGE TABLE (PD 



IM^aEDl ATELY follows an ASTE (ABOVE) - ONE PER ACTIVE SEGMENT 
COMES IN 4. 16 64 AND 256K FLAVORS 



THE PAGE TABLES (PT'S) ARE HARDCORE (SST), UNPAGED, DATA BASES EACH 
CONSISTING OF AN ARRAY OF PAGE TABLE WORDS (PTW'S) 



ONE PAGE TABLE PER ACTIVE SEGMENT 



4, 16, 64, OR 256 PTW PER PAGE TABLE 
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PAGE CONTROL DATA BASES 



PAGE TABLES 



B ALL PAGE TABLES ARE ASSOCIATED WITH, AND IMMEDIATELY FOLLOW AN ASTE 
IN THE AST REGION OF THE SST 



EACH PTW DESCRIBES THE STATUS OF ONE PAGE OF THE SEGMENT CURRENTLY 
IN POSSESSION OF THE ASSOCIATED ASTE, INCLUDING: 



THE DEVICE ADDRESS OF THE COPY OF THE PAGE 

PTW VALID INDICATOR AND FAULT NUMBER (FAULT #1) 



FLAGS INDICATING VARIOUS STATES AND PROPERTIES OF THE PAGE SUCH 
AS I/O IN PROGRESS, WIRED, USED, MODIFIED 



THE ADDRESS PORTION OF EACH PTW IS INITIALIZED FROM THE SEGMENT'S 
VTOCE FILE MAP AT SEGMENT ACTIVATION TIME 
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PAGE CONTROL DATA BASES 
CORE MAP 
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(WORDS) 



CORE MAP ENTRY (CME) 

A HARDCORE DATABASE, LOCATED IN THE 
CORE-MAP SEGMENT. ONE CME PER CONFIGURED 
FRAME OF MAIN MEMORY. 



Icmp.inci.alml 



ARRAY OF CORE MAP ENTRIES (CME'S) 



ONE CORE MAP PER SYSTEM 



ONE CME PER ADDRESSABLE MAIN MEMORY FRAME 



IF THE CONFIGURATION HAS HOLES IN THE MEMORY ADDRESS 
ASSIGNMENTS, OR MEMORIES WHICH ARE TURNED OFF, THOSE CMES ARE 
PRESENT ANYWAY (BUT UNUSED) (0 TO HIGHEST FRAME ADDRESS) 
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PAGE CONTROL DATA BASES 
CORE MAP 



B EACH CME DESCRIBES THE STATUS OF ONE PAGE FRAME IN MAIN MEMORY 
INCLUDING; 



THE DISK ADDRESS OF THE PAGE CURRENTLY OCCUPYING THE FRAME 
ADDRESS OF THE ASTE AND PTW OF THE OCCUPANT 



FLAGS INDICATING VARIOUS STATES AND PROPERTIES OF THE FRAME AND 
ITS OCCUPANT SUCH AS I/O IN PROGRESS, NOTIFICATION REQUESTED, 
AND PIN WEIGHT 



THE CME'S ARE KEPT IN A DOUBLE -THREADED CIRCULAR LIST POINTED TO BY 
ssc.useda 



._ — ,»,^,. r■r»TT^T^T,^;-^T«^ T /r\ Tvot? T'trMDnD 1 D T T. V THPF". JkDF.D OUT OF 

. THE LIST 



i CME'S FOR FRAMES CONFIGURED BUT NOT PHYSICALLY PRESENT ARE ALSO 
THREADED OUT BUT WITH THREAD WORD "777777777777" OCTAL 



THE REMAINING CME'S REPRESENT MAIN MEMORY FRAMES ACTIVELY IN USE 
- AND SUBJECT TO EVICTION BY THE PAGE REPLACEMENT ALGORITHM 
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PAGE CONTROL DATA BASES 
SYSTEM SEGMENT TABLE (SST) HEADER 



THE FIRST - 512 WORDS OF THE SST IS CALLED THE SST HEADER AND 
CONTAINS: 



A LARGE NUMBER OF GLOBAL VARIABLES VITAL TO THE OPERATION OF THE 
STORAGE SYSTEM AND ITS SUBSYSTEMS 



NUMEROUS CELLS USED TO METER THE STORAGE SYSTEM 



B AMONG THOSE OF INTEREST TO PAGE CONTROL ARE THE FOLLOWING: 

J GLOBAL VARIABLES: 

PAGE TABLE LOCK (sst.ptl) 

1 NUMBER OF MAIN MEMORY FRAMES AVAILABLE FOR PAGING ACTIVITIES 
(sst.nused) AND NUMBER WIRED (sst. wired) 

D POINTERS TO THE BASE OF THE CME ARRAY AND TO THE' CME OF THE 
"BEST" CANDIDATE PAGE FOR REPLACEMENT 

PVT INDEX OF THE RPV (USED DURING INITIALIZATION) 



D METERS 

THRASHING, POST-PURGE-TIME, PAGE FAULTS ON DIRECTORIES, RING 
PAGE FAULTS, LOOP LOCK TIME, SEGMENT MOVES 
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PAGE CONTROL DATA BASES 
SYSTEM SEGMENT TABLE (SST) HEADER 



PAGING METERS REPORTED BY f ile_system__meters SUCH AS STEPS, 
NEEDS, CEILING, SKIPS 
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PAGE CONTROL DATA BASES 
OTHER DATA BASES 



ALTHOUGH BASICALLY DATA BASES OF VOLUME MANAGEMENT, THE FOLLOWING 
CONTAIN INFORMATION REQUIRED BY PAGE CONTROL (AS INDICATED) 



a PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 

I INFORMATION REQUIRED BY THE DISK DIM FOR I/O 

INFORMATION USED BY THE DISK RECORD ALLOCATOR/DEALLOCATOR 
(free_store) SUCH AS: 

THE NUMBER OF UNALLOCATED RECORDS LEFT ON THE VOLUME 

THE LOCATION OF THE RECORD STOCK FOR THE VOLUME 



B RECORD STOCKS 



RECORD STOCKS ARE KEPT IN A WIRED SEGMENT: stock_seg 



THE RECORD STOCK FOR A VOLUME IS A LIST OF SOME OF THE RECORDS 
WHICH ARE FREE ON THE VOLUME 



WHEN THERE ARE NO MORE ENTRIES AVAILABLE IN THE STOCK, IT IS 
UPDATED FROM THE VOLUME MAP 
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PAGE CONTROL DATA BASES 



OTHER DATA BASES 



IF THE STOCK BECOMES FULL, SOME OF ITS ENTRIES ARE UPDATED TO 
THE VOLUME MAP AND REMOVED FROM THE STOCK 



A COMPLEX MECHANISM (SEE volmap.alm, volmap_page .aim) MAKES 
IT POSSIBLE TO REFERENCE THE VOLUME MAP PAGES WHILE 
SATISFYING A PAGE FAULT 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



B WITHIN ANY DEMAND PAGING ENVIRONMENT THE CHOICE OF WHICH PAGE TO 
EVICT IS CRUCIAL TO SYSTEM PERFORMANCE 



ONE OF THE BETTER CHOICES FOR EVICTION IS THE "LEAST RECENTLY USED" 
PAGE.... OR (BECAUSE OF EFFICIENCY), THE "LEAST RECENTLY NOTI CEP AS 
BEING USED" PAGE. 



THE MULTICS PAGE REPLACEMENT ALGORITHM (PRA) , KNOWN IN THE 
LITERATURE AS THE "CLOCK" ALGORITHM WAS ONE OF THE FIRST EVER TO BE 
IMPLEMENTED 



B THE VERSION AS IT EXISTS TODAY IS A DIRECT DESCENDANT OF Corbato's 
ORIGINAL ALGORITHM (SEE SECTION 5 OF THE "MULTICS STORAGE SYSTEM 
PLM", AN61, FOR A BIBLIOGRAPHY) 



PAGES ARE KEPT IN A CIRCULAR LIST, THE CORE USED LIST, IMPLEMENTED 
BY THE DOUBLY THREADED CME'S 



A POINTER, MAINTAINED IN THE SST, (sst.usedp) POINTS TO THE LOGICAL 
HEAD OF THIS LIST AS FOLLOWS: 
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SERVICES OF PAGE CONTROL 
PAGE FAULT HANDLING 




BEST 
CANDIDATE 



SKIP USED = 1 
SKIP MOD = 1 
STEPS = 3 



THE CLOCK ALGORITHM 



1. THE "REPLACER" SEARCHES FOR THE FIRST PAGE WHICH IS NEITHER WIRED NOR 
MODIFIED, AND HAS NOT BEEN USED SINCE LAST INSPECTED, MAKING THAT PAGE 
IMMEDIATELY AVAILABLE TO THE REQUESTOR. 

2 THE "PURIFIER" THEN CATCHES UR INITIATING WRITES FOR ALL "NOT USED-BUT 
MODIFIED" PAGES PASSED OVER BY THE "REPLACER" AND TURNING OFF THE USED 
FLAG FOR ALL USED PAGES. 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



B PAGE FAULT HANDING IS THE MOST VISIBLE AND CRUCIAL SERVICE OF PAGE 
CONTROL 



A PAGE FAULT OCCURS WHEN A USER REFERENCES A 
THAT IS NOT IN MAIN MEMORY 



PAGE OF SOME SEGMENT 



OR MORE SPECIFICALLY: HARDWARE ATTEMPTS TO USE A PTW THAT 
INDICATES ITS PAGE IS NOT IN THE MAIN MEMORY 



PAGE FAULT HANDLING IS IMPLEMENTED IN THE ALM PROGRAM page_fault 
WHICH IS INVOKED DIRECTLY BY THE FAULT VECTOR CODE (page_fault ^S 






B THE PRINCIPAL STEPS OF page_fault ARE: 



SAVE ALL MACHINE CONDITIONS, MASK AGAINST INTERRUPTS, AND 
ESTABLISH A STACK FRAME ON THE BASE OF THE PROCESSOR DATA 
SEGMENT (PRDS), WHICH IS USED AS THE STACK FOR INTERRUPTS AND 
PAGE FAULTS 



11 CHECK FOR ILLEGAL CONDITIONS AND CRASH IF SO 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



ATTEMPT TO LOCK THE PAGE TABLE LOCK (sst.ptl) AND WAIT IF 
UNSUCCESSFUL 



LOCATE THE RESPONSIBLE PTW AND ITS ASTE. THIS IS OFTEN THE MOST 
DIFFICULT TASK 



IT IS DIFFICULT BECAUSE IT REQUIRES FETCHING THE SDW FROM THE 
DSEG, WHICH IS, ITSELF, PAGED, AND NOT GUARANTEED TO BE IN 
MEMORY 



CHECK FOR TWO WINDOW SITUATIONS INVOLVING SOME OTHER PROCESS 
HANDLING A PAGE FAULT FOR THE SAME PAGE: 



IF PAGE IS NOW IN, THEN UNLOCK THE LOCK AND RESTART THE 
MACHINE CONDITIONS 



IF PAGE IS BEING READ IN NOW, DEVELOP THE WAIT EVENT FOR THE 
PTW AND SKIP THE NEXT THREE STEPS 



INVOKE read_page TO FIND THE LEAST RECENTLY (NOTICED AS BEING) 
USED MAIN -MEMORY FRAME, BEGIN THE PAGE-READING FUNCTION, AND 
DEVELOP THE WAIT EVENT 



EXECUTE THE REPLACEMENT ALGORITHM'S WRITE-BEHIND (PURIFIER) 
FUNCTION, CAUSING PASSED OVER WRITE REQUESTS TO BE QUEUED 



METER THE PAGE FAULT TO INCLUDE: TIME SPENT; MAIN MEMORY USAGE 
OF THIS PROCESS; RING ZERO, DIRECTORY, AND PER-PROCESS FAULTS 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



TRANSFER TO THE TRAFFIC CONTROLLER, WHO PLACES THE PROCESS IN 
THE WAIT STATE, UNLOCKS THE PAGE TABLE LOCK, AND ABANDONS THE 
ENVIRONMENT (SEE "TRAFFIC CONTROL", TOPIC 10) 



WHEN THE PAGE READING I/O IS COMPLETE, THE EVENT WILL BE POSTED. 
THE WAITING PROCESS WILL BE GIVEN THE PROCESSOR AGAIN AND TRAFFIC 
CONTROLLER WILL TRANSFER THE FAULTING PROCESS TO 
page_fault$wait_return TO RESTART THE MACHINE CONDITIONS 
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PAGE FAULT SCENARIO 

SCENE 1: AFTER SEGMENT ACTIVATION 

1. ASTE/PT PAIR FREED AND ALLOCATED TO SEGMENT A 

2. VTOCE'S ACTIVATION DATA COPIED INTO ASTE 

3. VTOCE'S FILE MAP DATA COPIED INTO PTW 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 
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PAGE FAULT SCENARIO 

SCENE 2: AFTER PAGE FAULT ON PAGE N0.2 

1. FRAME 3702 FREED AND ALLOCATED TO PAGE NO. 2 
Z PAGE NO. 2 COPIED INTO FRAME 3702 

3. ADDRESS IN PTW NO. 2 COPIED TO CME 3702 

4. ADDRESS IN PTW NO. 2 REPLACED WITH MAIN MEMORY ADDRESS 
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PAGE FAULT HANDLING 
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SEGMENT A's 
PAGE TABLE 



PAGE FAULT SCENARIO 

SCENE 3: AFTER PAGE FAULT ON PAGE NO. 1 

1. FRAME 5614 FREED AND ALLOCATED TO PAGE-NO. 1 

2. FRAME 5614 ZEROED BECAUSE OF PTW N0.1 's NULL ADDRESS 

3. RECORD 2103 ALLOCATED TO PAGE N0.1 

4. ADDRESS FOR RECORD 2103 WRITTEN INTO CME 5514 AS A NULLED ADDRESS 
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PAGE FAULT HANDLING 
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PAGE FAULT SCENARIO 

SCENE 4A: PAGE N0.1 (UNMODIFIED) EVICTED FROM MAIN MEMORY 

1. NULLED ADDRESS IN CME 5614 COPIED TO PTW N0.1 

2. CME 5614 FREED 
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PAGE FAULT SCENARIO 

SCENE 5A: AFTER SEGMENT DEACTIVATION 

1 PAGE NO. 2 EVICTED FROM MAIN MEMORY AFTER ADDRESS IN CME 3702 COPIED TO PTW NO. 2 

2. PTW ADDRESSES WRITTEN TO VTOCE FILE MAP WITH NULLED ADDRESS IN PTW NO. 1 
CONVERTED TO A NULL ADDRESS 

3. RECORD 2103 FREED 

4. ASTE/PT PAIR FREED 
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PAGE FAULT SCENARIO 

SCENE 4B: PAGE NO.KMOOIFIED) EVICTED FROM MAIN MEMORY 
(AND DISK I/O KNOWN TO BE COMPLETE) 

1. FRAME 5614 WRITTEN TO RECORD 2103 

2. NULLED ADDRESS IN CME 5614 RESURRECTED AND COPIED TO PTW NO. 1 

3. CME 5614 FREED 
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PAGE FAULT SCENARIO 

SCENE SB: AFTER SEGMENT DEACTIVATION 

1. PAGE NO. 2 EVICTED FROM MAIN MEMORY 

2. PTW ADDRESSES WRITTEN TO VTOCE FILE MAP 

3. ASTE/PT PAIR FREED 
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SERVICES OF PAGE CONTROL 
POST PURGING 



s POST PURGING IS PERFORMED BY THE PROCEDURE post_purge 



POST PURGING IS AN OPTIONAL SERVICE USED TO OPTIMIZE THE PAGE 
REPLACEMENT ALGORITHM 



B POST PURGING: 



FAVORS THE REPLACING OF PAGES USED BY A PROCESS WHICH HAS JUST 
LOST ELIGIBILITY (SEE "TRAFFIC CONTROL", TOPIC 9) 



IS A WORK CLASS SETTABLE ATTRIBUTE 



POST PURGING IS LARGELY USELESS TODAY, BECAUSE MAIN MEMORY SIZE IS 
SO MUCH GREATER 
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PAGE CONTROL METERS 
file system meters 



FI LE_S YSTEM_METERS 
FOR THE FILE SYSTEM 



DISPLAYS MISCELLANEOUS METERING INFORMATION 



ONLY PARTS RELEVANT TO PAGE CONTROL INCLUDED HERE; SEE TOPIC 7 
(SEGMENT CONTROL) FOR THE REST 
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TRAFFIC CONTROL OVERVIEW 



FUNCTION 



8 TRAFFIC CONTROL (OR THE "TRAFFIC CONTROLLER") IS RESPONSIBLE FOR 
MANAGING THE ASSIGNMENT OF PHYSICAL PROCESSORS TO MULTICS 
PROCESSES AND IMPLEMENTING THE SYSTEM'S WAIT/NOTIFY AND 
INTERPROCESS COMMUNICATION PRIMITIVES 



D THE FUNCTIONS ASSUMED BY THE TRAFFIC CONTROLLER ARE KNOWN AS 
MULTIPROGRAMMING, MULTIPROCESSING, SCHEDULING, DISPATCHING, 
PROCESSOR MANAGEMENT, AND INTERPROCESS COMMUNICATION. 



ITS MAJOR FUNCTION IS ALLOWING PROCESSES TO AWAIT THE COMPLETION 
OF FILE SYSTEM OPERATIONS, SUCH AS PAGE I/O 



1 TRAFFIC CONTROL CAN BE INVOKED BY SUBROUTINE CALLS AND 
INTERRUPTS 



THERE ARE NO IMPORTANT USER SUBROUTINE INTERFACES, BUT THERE ARE 
PRIVILEGED SUBROUTINE INTERFACES FOR PROCESS CREATION, 
ADJUSTMENT OF SCHEDULING PARAMETERS, ETC. 



B MAJOR DATA BASES 



TC_DATA SEGMENT - ONE PER SYSTEM. CONTAINS THE FOLLOWING FOUR 
DATA BASES: 

TC_DATA HEADER - ONE PER SYSTEM 

I CONTAINS VARIOUS METERS, COUNTERS AND POINTERS USED BY THE 
TRAFFIC CONTROLLER 
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TRAFFIC CONTROL OVERVIEW 



ACTIVE PROCESS TABLE (APT) - ONE PER SYSTEM 

ACTIVE PROCESS TABLE ENTRY (APTE) - ONE OCCUPIED PER 
ACTIVE PROCESS (TOTAL NUMBER IS DETERMINED BY CONFIG DECK) 

D EACH APTE CONTAINS VARIOUS ATTRIBUTES OF AN ACTIVE PROCESS 
INCLUDING THE PROCESS ID, STATE, THE VALUE OF ITS 
DESCRIPTOR BASE REGISTER (DBR) , SCHEDULING PARAMETERS, AND 
* A POINTER TO THE PROCESS'S ITT ENTRIES 

J THE APTE CONTAINS ALL INFORMATION THE SUPERVISOR NEEDS TO 
KNOW ABOUT A PROCESS WHEN THE PROCESS IS NOT RUNNING 



INTERPROCESS TRANSMISSION TABLE (ITT) - ONE PER SYSTEM 

O ITT ENTRY - ONE OCCUPIED PER OUTSTANDING IPC WAKEUP 

i A QUEUE FOR TEMPORARILY STORING IPC WAKEUP INFORMATION 
(CHANNEL NAME, RANDOM DATA, PROCESS ID, ETC) 

WORK CLASS TABLE (WCT) - ONE PER SYSTEM 

WORK CLASS TABLE ENTRY (WCTE) - ONE PER WORKCLASS 

EACH WCTE CONTAINS ADMINISTRATOR DEFINED PARAMETERS OF THE 
WORKCLASS, VARIOUS METERS AND POINTERS 
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PROCESS : 



AN ADDRESS SPACE 
ADDRESS SPACE 



AND AN EXECUTION POINT WITHIN THAT 



MULTI PROGRAMMI NG : 

PERTAINING TO 



THE CONCURRENT EXECUTION OF TWO OR MORE 



PROGRAMS BY INTERLEAVING THEIR EXECUTION 



MULTIPROCESSING: 

PERTAINING TO THE SIMULTANEOUS EXECUTION OF TWO OR MORE 
PROGRAMS BY A MULTIPROCESSOR SYSTEM (PARALLEL 
PROCESSING) 



ELIGIBLE: 



AN ADJECTIVE DESCRIBING THOSE PROCESSES ACTIVELY 



ELIGIBLE OR INELIGIBLE 



A^*> 




SCHEDULING: 



DISPATCHING: 



ys~C^ 



k'.V^?7 



eU<-vfi^' 



PERTAINS TO THE ACT OF CHOSING AND PROMOTING AN 
"INELIGIBLE" PROCESS TO "ELIGIBLE" STATUS 



5^ 



^"^^ 



PERTAINS TO THE ACT OF CHOSING AND PLACING AN ELIGIBLE 
PROCESS IN THE "RUNNING" STATE (IE: EXECUTING 
INSTRUCTIONS ON A PROCESSOR) 
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TRAFFIC CONTROL TERMINOLOGY 



WORK CLASS: A WELL DEFINED SET OF USERS (USUALLY CONSISTING 

OF ONE OR MORE PROJECTS) HAVING COMMON PERFORMANCE 
PARAMETERS. THE USER COMMUNITY MAY BE DIVIDED INTO NO 
MORE THAN 16 WORK CLASSES 



WORKING SET: Co((?(l.i^'v of '^f^i r^t^^M i^ cere f^ (^^y I T '/ "^^ . \y 1- r"^ "^W ^^"f ^■ 
THE SET OF PAGES A PROCESS TOUCHES DURING A GIVEN 
INTERVAL. THE SIZE OF A CURRENT WORKING SET' IS 
PREDICTIVE OF FUTURE MEMORY REQUIREMENTS 









]0 4:.^ ^^^.^^ ^.oCPi^^S ©5^^ W^rJ ^fs^^^^^ 






X 
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TRAFFIC CONTROL DATA BASES 
TC DATA 



tc data HEADER 



WORK CLASS TABLE (WCT) 
(0:16) 



ACTIVE PROCESS TABLE (APT) 
( 0:CONFIGURED ) 



INTERPROCESS TRANSMISSION TABLE (ITT) 
( 0:CONFIGURED ) 



TC.DATA 

A WIRED DATA BASE - ONE PER SYSTEM 
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TRAFFIC CONTROL DATA BASES 



TC DATA 



12 3 4 6 6 7 



111111111122222222223:^333 
90l23<S67S9ei23<!ST990ia3i; 



FORWAHO R.PTH 



BACKWARD R PTR 



■ ; A I T I 6 ' • 1 I 



1. I d| in I £ J J 



EXECUTION STATE 



NUMBER OF PAGE FAULTS 



PROCESS IDENTIFIER 



TIME HAS BEEN ELIGIBLE (Til 



TIME SINCE Tl CHANGED (TSI 



TIME SINCl LAST INTERACTION (Til 



MAXIMUM VALUE FOR Tl (TIMAXI 



IPC EVENT THREAD 



9 
10 



12 
13 



IPS ME5SAGEIS) 



R_PTR TO ASTE OF POS 



R_PTR TO ASTE OF DSEG 



R_PTR TO ASTE OR PROS (WHILE RUNNING) 



EXECUTION POINT (IN TRAFFIC CONTROL,' 



PROCESS IDENTIFIER TO NOTIFY ON TERMINATION 



LOCK IDENTIFIER 



CPU TIME USED 



WAIT EVENT 



WORK CLASS TABLE INDEX 



SP WAKEUPS 



TIME OF LAST STATE CHANGE 
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20 
21 
22 
23 
24 
2S 
2S 
27 
28 
29 
30 
31 
32 
33 
31 
35 
36 
37 
38 
39 
40 



TRAFFIC CONTROL DATA BASES 



TC DATA 



MAKEUP EVENT FOR ALARM CLOCK MANAGEH 



ALARM TIME THREAD 



ALARM TIME 



EVENT CHANNEL TO NOTIFY ON PROCESS TERMINATION 



VVORKINQ SET ESTIMATE 



MAXIMUM VALUE FOR TE ITEMAXI 



DEADLINE SCHEDULING TIME 



APTELOCK 



!« " ** 

6t . ' < s 



. H P ^^ ■m ..i.ii.. j . ^ [ I I 1,;;^^ 



CPU MONITOR 



PACINO MEASURE 



aj-Cf*^ ISOLATION MECHANISM lAIMI CLASS 



DESCRIPTOR 8ASE REGISTER VALUE lOBfll 



VIRTUAL CPU TIME 



ITT MESSAGES SENT AND NOT READ OUT 



ITT MESSAGES RECEIVED AND NOT READ OUT 



12 WORDS OF PADDING (TO 64 WORDS) 

ACTIVE PROCESS TABLE (APTl 

A HARDCORE ltc_aatal DATA BASE - ONE PER SYSTEM 
CONSISTS OF AN ARRAY OF APTE'S AS ABOVE 

ACTIVE PROCESS TABLE ENTRY (APTEi 

ONE PER ACTIVE PROCESS 





8 WORDS FOR RESPONSE TIME METERING 

— — \_— 


— 1 




SAVED VALUE OF TEMAX 


PBGCS REQUIRED iililsljiK/^yiililii^ 




\ ■ 




1 
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SERVICES OF TRAFFIC CONTROL 



WAIT LOCKS 



WAIT 
EVENT 



ADD 
EVENT 



K) 

r 



WAIT LOCKS 



NOTIFY 
EVENT 



I DELETE 
^^ EVENT 



->M**wM-^ J 
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SERVICES OF TRAFFIC CONTROL 
PROCESSOR MULTIPLEXING 



SINCE THE NUMBER OF ACTIVE PROCESSES GENERALLY EXCEEDS THE NUMBER 
OF PROCESSORS {OFTEN 50 tl) THE PROCESSORS MUST BE MULTIPLEXED 



PROCESSOR MULTIPLEXING IS THE PRIMARY RESPONSIBILITY OF THE TRAFFIC 
CONTROLLER 



B THE MULTICS ARCHITECTURE DICTATES THE FOLLOWING AXIOMS: 



ALL PROCESSORS ARE SYMMETRICAL 



AN INTERRUPT IS SEEN BY ALL PROCESSORS AND IS SERVICED BY THE 
PROCESSOR THAT CLAIMS IT FIRST 

I NOT ACTUALLY TRUE, DUE TO HARDWARE CONNECTION LIMITATIONS 

THERE ARE NO MASTER OR SLAVE PROCESSORS. ONLY A PROCESSOR 
DESIGNATED TO PERFORM BOOTLOAD AND SHUTDOWN (THE "BOOTLOAD 
PROCESSOR" ) 

BOOTLOAD PROCESSOR CAN BE CHANGED AT ANY TIME BY DYNAMIC 
RECONFIGURATION 



A PROCESSOR MAY BE "IN" AT MOST ONE PROCESS AT A TIME 



A PROCESS MAY EXECUTE ON ONE AND ONLY ONE PROCESSOR AT A TIME. 
THE PROCESS MAY, HOWEVER, "RANDOMLY" MIGRATE FROM ONE PROCESSOR 
TO ANOTHER 
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SERVICES OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 



A PROCESSOR WILL, AT ALL TIMES, BE "IN" A PROCESS 



B PROCESSES MAY EXIST IN ONE OF SIX STATES - ONE OF WHICH IS 
"RUNNING" {IE: EXECUTING ON A PROCESSOR) 



THE TRAFFIC CONTROLLER CODE PERFORMS ALL STATE CHANGES. THE STATS 
CHANGES FALL INTO TWO CATEGORIES: SELF IMPOSED AND EXTERNALLY 
IMPOSED. 



S SELF IMPOSED STATE CHANGES (THE PROCESS MUST HAVE A PROCESSOR! 



i RUNNING -> READY (#1 -> #2) 

I THE PROCESS WAS TOLD (BY EITHER A CONNECT FAULT FROM 
ANOTHER PROCESSOR OR A TIMER RUNOUT)' -TO GIVE UP ITS 
PROCESSOR 

J THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 



RUNNING -> WAITING (#1 -> #3) 

n THE PROCESS ISSUED A REQUEST FOR A "SYSTEM EVENT" (EG: A 
PAGE FAULT OR A WAIT LOCK) 

J "SYSTEM EVENTS" OCCUR AFTER A PREDICTABLY SHORT PERIOD OF 
TIME AND ARE HANDLED BY THE WAIT/NOTIFY MECHANISM 

1 THE PROCESS IS NOW WAITING FOR A NOTIFY INDICATING THE 
COMPLETION OF THE EVENT (EG: THE ARRIVAL OF THE PAGE IN 
MAIN MEMORY) 
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SERVICES OF TRAFFIC CONTROL 
PROCESSOR MULTIPLEXING 



8 RUNNING -> PAGE TABLE LOCK WAITING (#1 -> #6) 

I THE PROCESS ATTEMPTED TO LOCK THE PAGE-TABLE LOCK AND 
FOUND IT ALREADY LOCKED 

I THE PROCESS IS NOW WAITING FOR A NOTIFY INDICATING THE 
UNLOCKING (A SYSTEM EVENT) 

H RUNNING -> BLOCKED (#1 -> #4) 

THE PROCESS ISSUED A REQUEST FOR A "USER EVENT" (EG: A 
READ FROM THE TERMINAL) 

"USER EVENTS" OCCUR AFTER A PREDICTABLY LONG PERIOD OF 
TIME AND ARE HANDLED BY THE BLOCK/WAKEUP MECHANISM 

J THE PROCESS IS NOW WAITING FOR A WAKE_UP INDICATING THE 
COMPLETION OF THE EVENT (EG: A LINE_FEED GENERATES A 
WAKE_UP) ARE HANDLED BY THE BLOCK/WAKE_UP MECHANISM 

B A PROCESS GOING BLOCKED GIVES UP ITS RING ZERO STACK 

I RUNNING -> STOPPED (#1 -> #5) 

D THE PROCESS EXECUTED THE logout OR new_proc COMMAND, 
EVENTUALLY CALLING hcs_$stop_process 

D THE PROCESS IS PROHIBITED FROM RUNNING AGAIN AND WILL 
QUICKLY BE DESTROYED BY THE INITIALIZER 
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PROCESSOR MULTIPLEXING 



J EXTERNALLY IMPOSED STATE CHANGES (THE STATE IS CHANGED BY 
ANOTHER PROCESS) 

READY -> RUNNING (#2 -> #1) 

B THE PROCESS (WHICH WAS WAITING FOR NO OTHER RESOURCE THAN 
A PROCESSOR) WAS CHOSEN AS SUCCESSOR BY A PROCESS 
RELINQUISHING A PROCESSOR 

I THE PROCESS IS NOW EXECUTING 



BLOCKED -> READY (#4 -> #2) 

D SOME OTHER PROCESS SENT A WAKEUP INDICATING THE COMPLETION 
OF THE EVENT THIS PROCESS WAS WAITING ON, AND CHANGE THE 
STATE OF THIS PROCESS 

I THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 



WAITING -> READY (#6 -> #2) 
PTL-WAITING -> READY (#3 -> #2) 

[ SOME OTHER PROCESS SENT A NOTIFY INDICATING THE COMPLETION 
OF THE EVENT THIS PROCESS WAS WAITING ON, AND CHANGED THE 
STATE OF THIS PROCESS 

I THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 
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TRAFFIC CONTROL STATES 













30. 



^"oV, 












IDLE 



ELIGIBLE PROCESSES (13) 



INELIGIBLE PROCESSES (87) 



ALL FIGURES ARE BASED ON METERS FROM A 100 USER, 3 CPU. 2.5IVI MEMORY. MAKE = 16 SYSTEM. 
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SERVI CSS OF TRAFFIC CONTROL 
PROCESSOR MULTIPLEXING 

TRAFFIC CONTROL SCENARIO 

SCENE 1: CPU "C" TAKES AN INTERRUPT 



1. EVENT 3331 OCCURES. 
CPU "C" TAKES THE 
INTERRUPT AND STORES 
MACHINE CONDITIONS 



2. May.FOI NOTIFIES 

Kelly.EREG BY CHANGING 
HIS STATE TO READY {r) 



3. May.FOI CALLS get-fH-ocessor 
WHICH LOOKS FOR AN 
EXECUTING (x) PROCESS 
LOWER THAN Kelly.EREG, 
FINDS IDLE_A, AND 
SENDS CPU "A" A CONNECT 
FAULT (cioc INSTRUCTION) 



4. May.FOI RESUMES PRIOR 
ACTIVITY BY RESTORING 
MACHINE CONDITIONS 
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SERVICES OF TRAFFIC CONTROL 
PROCESSOR MULTIPLEXING 

TRAFFIC CONTROL SCENARIO 

SCENE 2: CPU "A" RECEIVES CONNECT FAULT 



1. CPU "A" RECEIVES CON- 
NECT FAULT AND STORES 
MACHINE CONDITIONS 



^ ldle_A BEGINS PRE- EMPTION 
BY CHANGING STATE TO 
READY (r) 



3. ldle_A CALLS get-work 
WHICH LOOKS FOR THE 
HIGHEST READY (rj 
PROCESS, FINDS Kelly.EREG, 
CHANGES HIS STATE TO 
EXECUTING (x) AND CPU 
TAG TO "A", AND LOADS 
HIS D6R 



4. Kelly.EREG RESUMES 
PRIOR ACTIVITY BY 
RESTORING MACHINE 
CONDITIONS 
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WORKING SETS AND PAGE THRASHING 



PAGE 

REFERENCE 

STRING 



CASE # 1 : 
MINIMAL. 
PAGE 
FAULTS 



CASE-#:2: 
UNNECESSARY 
PAGE 
FAULTS 



AB A CDA CDB E FCD CDFE FED GF 



(§)(D A ©©A CDB (D 0C D CEFE FED(s)f| J7 PAGE FAULTSI 



(gXD A ©©A C D(b) © (gXBD CEFE FE(B)(6)F 



(10 PAGE FAULTSJ 
HP*^ TIME 



N 



WORKING SET = 7 PAGES 
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• CASE #:1 : THRASHING = ^= 0% 



• CASE 4^ 2 : THRASHING = 
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PROCESSOR MULTIPLEXING 



IDLE CATEGORIES 



ZERO 
IDLE 



ndY e/ioc.ojA Yft >tB'/ IDLE 



Woul/ Wt"' ^'^ LOADING 
vS?«( fey' So^fo-v?. (lu-'i'lDLE 

CPU 5''^S l^-c i WORKCLASS 

'^<s V'QIJI \<nS'^'''^ IDLE 

CfcJ5 



ELIGIBLE 
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RUNNING 


WAITING 


READY 
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WORKCIASS 
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TRAFFIC CONTROL METERS 



f<rv 



J\ 



total time meters 



f fc^ivx 



&oT;<^^ 



TOTAL_TIME_METERS - OVERVIEW OF HOW THE SYSTEM IS USING ITS 
RESOURCES, ALSO MEASURED AGAINST NON-IDLE TIME 



or 






Total metering time 



0:20:36 
%NI 



prfe' 



A<?'^ 



Page Faults 6o55 

PC Loop Locks 0.39 

PC Queue 0.86 

Seg Faults 1.74 

Bound Faults 0.15 

Interrupts 9.02 

>Other Fault 8.45 

TGetwork 4.54 

\tC Loop Locks 0.20 

vj'ost Purging 0.36 

MP Idle 0.70 

Work Class Idle 0.98 

Loading Idle 0.16 

NMP Idle 8.84) 

Zero Idle 0.005' 

Other Overhead 0.03 

Virtual CPU Time ^. 5 J 



M>lf"f^^ 



AVE 




.\ 



2130.424 
1993.209>ei/^r (j. 

348.9463'^'^*'^ '^^'^^'^ \ 

9 5 7 9 . 1 7 ft'-'^- '"^ -^i) ^ ^e Act' ^-'\- -^"j s^a^i ] 






'> ^5T 



17426.208 . 

1713.504 W'=^rM To h^i fif-^iT MfWlTy 



660.550 

247.788 

1407.132 

. 7 7 ■^'"^if lost- <3ec/9^$^ 

1.08 

0.17 



0.39^€i 



lvx« ^ P -sK^v li h C ' »' 3 "^^ 



I I, 

0.04 
68.59 






o^dS 
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TRAFFIC CONTROL METERS 
traffic control meters 



a TRAFFIC CONTROL METERS - DISPLAY THE STATE OF THE SCHEDULER 



OUTPUT COMES IN THREE PARTS, SHOWN OUT OF ORDER HERE; 

QUEUE LENGTHS AND RESPONSE TIME - THESE ARE WEIGHTED AVERAGES 
OVER THE LAST FIFTEEN SECONDS. 

D ACTIVITIES VERSUS DEPTH - HOW DEEP THE TRAFFIC CONTROLLER HAD 
TO SEARCH TO FIND A SCHEDULABLE PROCESS 

1 MISCELLANEOUS COUNTERS AND FREQUENCIES OF VARIOUS EVENTS 

Total metering time 0:20:34 M^cici- -^^^"^ 

Ave queue length 16.52-"^'''' 

Ave eligible 13.31 &^fi ^'^^^ -^A^iW V- -^"r 



VA 



Response time 0.264 sec C^-^v ^^'"'"'^tAT «^\ eKif^^ 



.^^'S: 



DEPTH %PF TBPF %GTW, TBS %CPU v^f ^fl? S'^'^' 



1 12.0 22. B 10.8 11.6 8.1 

2 11.8 21.0 9.2 12.2 7.4 

3 10.8 24.9 8.7 14.1 8.0 

4 10.2 27.9 8.5 15.2 8.4 

5 9.5 29.8 8.3 15.5 8.4 

6 8.4 33.5 7.8 16.5 8.4 

7 7.4 36.3 7.3 16.8 8.0 

8 30.0 48.6 39.5 16.8 43.3 



f^^?.^^^^^^T^,i GO J .4-cr^.^-^ o^ fe3«<^-S^ ^■^^^• 
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traffic control meters 



COUNTER 



i\JL n.imi 



ATB 



#/INT 



Interactions 

Loadings 

Blocks 

Wakeups 

Schedulings 

Lost priority 

Priority boosts 

I/O boosts 

Wait Page 

Wait PTL 

Wait Other 

Total Waits 

Notify Page 

Notify PTL 

Notify Other 

Total Notifies 

Get Processor 

Pre-empts 

Getwork 

Retry getwork 

Extra notifies 
Last EN event 
Last NTO event 



7977 


0.155 


sec 






12161 


0.102 


sec 


1, 


.525 


14082 


0.088 


sec 






36078 


0.034 


sec 






12591 


0.098 


sec 


1, 


.578 


1 


1234.756 


sec 









0.000 


sec 






578 


2.136 


sec 






127040 


9.719 


msec 


15. 


.926 


75691 


16.313 


msec 


9, 


,489 


31912 


38.693 


msec 


4, 


.001 


234643 


5.262 


msec 


29, 


.415 


128954 


9.575 


msec 






75691 


16.313 


msec 






25330 


48.747 


msec 






229975 


5.369 


msec 






245856 


5.022 


msec 






94235 


13.103 


msec 


11, 


,813 


338802 


3.644 


msec 






4988 


0.248 


sec 






2949 


0.419 


sec 






000000000071 








033022237767 









ALARM_CLOCK_METERS - DISPLAYS INFORMATION ABOUT THE USER ALARM 
TIMER FACILITY (HARDCORE INTERFACE FOR t imer_manager_) 



Total metering time 



0:20:31 



No. alarm clock sims. 
Simulation lag 
Max. lag 



2171 

5.245 msecs. 
1.7340314e4 msecs, 
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TRAFFIC CONTROL METERS 
traffic control queue 



TRAFF IC CONTROL_QU£UE - DISPLAYS THE 
SCHEDULER QUEUES, USEFUL FOR GETTING 
PROCESSES ARE DOING ^v-^^ 



CURRENT 
AN IDEA 



content: 

OF WHAT 



Ul^ ^^ 



OF THE 
THE USER 



CD^-f 



v/cx:.' 



-fO 



< 



,^ I 



-Tv•'^^ 



FIRST PART OF OUTPUT 



'^ 






avq = IS.Xelapsd^ titn\ = 121*7 
flags dtu dpf temax te 



<<!' 



,<U-rWLE(d) U8 

15 



rLE(d) 

v») wLE (d) 

•^■^^ xWLED (5) 

1e (d) 
wWLE (b) 
wLE it) 
wLE (b> 
wLE (d) 
>;LED (c) 
rLEld) 






\eA' 



rA 




- > 
* -* 

6 
Ifc 

17 

12 

65 

12 
67 



^^ 







\^(h' 



fl"?) 



IJH 



KlS" 



.^^ 



o< 



Se^ 






z' Wo**- 

ws wc process 
6 initial izer "^ 
6 Sibert 
h Diaz 
8 JCrow 

3 G intel 1 
6 Brune I le 

6 WFeck 

3 Sprat: 

k RTowle 
3 Kress 

2 OPCTL 
3 Pancolf 
3 Lackey 






/ 
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TRAFFIC CONTROL METERS 
traffic control queue 



I SECOND PART IS REALTIME, INTERACTIVE, AND ALL WORKCLASS QUEUES: 

REALTIME QUEUES 

INTERACTIVE QUEUE: 

WORKCLASS 2 QUEUE: credits = 576 ms . 

WORKCLASS 3 QUEUE: credits = 242 ms. 

r 2S9 5326 1000 503 0.21B 22 3 DuDuis 

r 131 2513 1000 4010 8000 0.12B 3 Falksenj 

WORKCLASS 4 QUEUE: credits = 2601 ms . 

WORrlCLASS 5 QUEUE: credits = 4000 ms. 

WORKCLASS 6 QUEUE: credits = -563 ms . 

WORKCLASS 7 QUEUE: credits = 3 962 ms . 

rW 5 166 50G .0 C.1S2 2 7 Saccuci 

wORrlCLASS 6 QUEUE: credits = 3934 ms . 

WORKCLASS 3 QUEUE: credits = 2216 ms. 

WORKCLASS ID QUEUE: credits = 4000 ms . 

WORKCLASS 11 QUEUE: credits = 4000 ms.' 
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TRAFFIC CONTROL METERS 
work class meters 



^^ ^T ^h\rT' cL^yY^ 



B WORK_CLASS_METERS - DISPLAY THE VARIOUS WORKCLASS PARAMETERS, AND 
SHOW WHAT RESOURCES EACH WORKCLASS IS CONSUMING. 



.\dO 



Total metering\^trTnBr' /t:20:38 a^'^^' 



WC %GUAR SMAX |T^P V/ELIG PW IRESP I QUANT RESP QUANT P M R I lZ.^\^At> ^ 



■P'> 










3. 


0.12 3 





26 


2 


10 


a. 26 


2 


10 


P R 


Init 


1 






3. 


0.09 1 





25 





75 


0.50 


1 


.00 


P R 


RTime 


2 


7. 




15- 


0.44 1 
















P 


SysteiT. SysAdm OPR FED 


3 


32. 




kh. 


0.49 1 
















P 


1 SysProg SysDev 


u 


. 


14. 


k 


0.26 1 
















P 


SEngr 


5 
6 


20 




2 


0.46 1 
















P 


1 HEngr 


12 


16. 


8 


0.25 1 
















P 


MktUS MktFor MktEd 


7 


5 


7. 


k 


. . 36 1 
















P 


DS-CC 


8 


fe 







0.18 1 
















P 


1 OffAuto 


9 


it 


8. 


2 


. 62 1 
















P 


Misc M^g 


10 
11 


3 

L 





2 


. 0.55 1 
0.16 1 
















P 

■p 


1 Other 
1 Special 



TCPJ percents (%GUAR) control non-realtime work_cl asses . 
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TRAFFIC CONTROL METERS id^o ^o.wl doT ^OfKl^o' H- 

'^ T^ '"t 3t'4 ii 

s RESPONSE .METERS - DISPLAYS RESPONSE TIME, BASED ON TERMINAL 
INTESACtToKS. on a PER-WORKCLASS BASIS 

Total meterino time 0:20:36 r^'^ t^o <o>^ ''^ 

WC C- — Tninks/-- ----Response Time¥- by VCPU Range ■ Load Control Group 

J^^--Qu£ijes--- -VCPU Range- # Avg Avg Resp 
^,«eX,^ - Ave From To lot VCPU RT Fact ,» ^< ce&5'="^'^' "' 

/> s^i^ So 2.70 0.00 0.50 ^ 113 0.04 0.i*2 5-3^4 Init 

I^P^ ^a-^ , 92 0.15 0.50 1.00 3 0.55 5-51 10. oo 

. '\v' ^^ov>> 1,00 10.00 3 2.43 U.96 6.15 

^ r^<^ — 119 0.12 O.Sl 7-76 

1 55 11.75 C.OC 0.5c lU O.li 0.S6 5.74 RTime 

3= 0.21 C.50 1.00 2 0.83 4.06 4-87 
._ — . . 3^ P.J5 1.13 7.55 

; 593 14.90 0.00 0.5c 620 C.05 0.43 10.50 System SysAarr 0?r FED 

612 G.I5 C.50 1.00 28 C.7I 3. 61 5.1c 

1.00 10.00 39 i.77 5.35 4.74 I , 
...__ 687 0.17 1.07 6.22_^.^U.0g-- ^.'^^ 

ki^ "Ef^ ~ ' 

3 2456 6-38 -^O-^- --50 2993 O.uB" 0.66 7-96. SysFrog SysDev 
2622 0.17^^^0.50 1.00 117 0.68 4.22 6-16 

/i.oo 10,00 66 2.46 13.47 .5-i*9 

MO. 00 9S.99 10 56.85 99-99 3-33 

__ 3Ig6 C.33 1-65 i*.96 

4 551 15-82 0.00 0.50 663 0.05 0.71 12.94 SEngr 
530 0.26 0.50 1.00 13 0.6^ 4.6L 7-30 

i.oc 10.00 8 3-i»7 32.07 9-21. 
^gi, 0.11 1.15 10.88 

5 133 29.51 0.00 0.50 148 0.06 0.83 12.35 HEngr 
r-n m ^ .rv ^ ^ ^^^ °-'7 O.50 1.00 3 0.69 k.i>k 6-70 

>nxv9 U i\ri^ e^r ^^^ 100 10.00 5 3.15 10.24 3-25 

C~ \ ~ ^ ~ T- 10.00 99.99 2 26.69 48.84 1.83 , 

\)\qqY- ftT 0,0? ^o ir .._ J5g 0,51 1.81 f3. 55/ 
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TRAFFIC CONTROL METERS 



10 



11 



A I 1 





11.65 


0.00 


resDons meters 


1.13 


20.91 




1180 


0.50 


977 


0.05 


MktUS Mk- 


1211 


0.58 


0.50 


1.00 


2k 


0.64 


4.95 


7.74 








1.00 


10.00 


16 


1.89. 


11.88 


6.29 












1017 


0.10 


1.39 


14.38 




259 


14.65 


0.00 


0.50 


292 


0.08 


1.53 


20.17 


DS-CC 


287 


0.98 


0.50 


1.00 


9 


0.71 


9.03 


12.66- 








1.00 


10.00 


17 


2.04 


14.76 


7.24 








10.00 


99.99 


1 


12.22 


99.99 


9.ii5 








, 




319 


0.24 


2.81 


11.86 




73 


2.69 


0.00 


0.50 


79 


0.06 


0.31 


5.45 


OffAuto 


74 


0.05 


C.50 


1.00 


2 


0.60 


6, to 


10.62 








1.00 


10.00 


1 
82 


3.20 

0.11 


6.73 
0.54 


2.10 

4.94 












Sk 


1*1.91 


0.00 


0.50 


80 


0.11 


1.23 


11.07 


Misc Mfg 


96 


0.30 


0.50 


1.00 


11 


0.69 


4.74 


6.91 








1.00 


10.00 


13 

lot 


2.99 
0.53 


12.62 
3.C5 


4.30 
5.74 




7 


99-99 


0.00 


c.50 


10 


0.11 


1.45 


13.82 


Other 


8 


0.21 


l.CO 


10.00 


1 

11 


3.88 

0.i(5 


39.11 
4.63 


10.03 
10.89 












uI7 


12.71 


0.00 


0.50 


kkS 


0.05 


0.50 


15.32 


Special 


k2C 


O.lo 


C.5C 


1.00 


5 


0.57 


3.fcl 


6.29 








1.00 


10.00 


k 

U5h 


1.65 

0.05 


11.40 
0.63 


6.90 
11.93 












535k 


11.13 


0.00 


0.50 


6454 


0.07 


C.77 


11. to 




6192 


0.29 


c.50 


1.00 


217 


0.68 


4.54 


6.70 








1.00 


10.00 


173 


2.31 


13.11 


5. 68 








10.00 


95-99 


13 
6357 


48.77 

0.21* 


99.95 
1.51 


3-32 
6-39 





86797 calls to meter_response_tinie 283 invalid transitions, 

Overhead = 0.09^ ( 0.052 ms./call) 
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TRAFFIC CONTROL METERS 

post puroe meters ^[o^^^ ^ 



POST PURGE METERS - DISPLAY THE STATS OF POST-PURGE ACTIVITY, 



CONSIDERABLY MORE DETAILED METERS ARE KEPT BY RING ZERO, BUT NOT 
REPORTED AND NOT PARTICULARLY INTERESTING. 



Total metering time 0:20:29 

Post purge time 1.41 msec. (0.36% of system) 

Ave list size 17.76 entries 

Ave working set 5.59 pages 

Working set factor 0.50 

Working set addend C 

Thrashing percentage 1.34 % 

Ave post in core 10.65 (59.94 %) 
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print tuning parameters 



,ASo CTP 



IS PRINT_TUNING_PARAMETERS - PRINT VALUES 
PARAMETERS. MOST CONTROL THE SCHEDULER 



FOR SYSTEM CONTROL 



Current system tuning parameters: 



h 
If- 



tef irst 
telast 
timax 

prior ity_sched_inc 
min_eligible 
max_eligible 
max_batch_elig 
working_set_factor 
working_set_addend 
deadline_mode 
int_q_enabled 
post_purge 
n ^ V &.«,^T .7-«/-/Pre empt sample time 

p.^.n .:<f.n..Ar^ '''"S^rX^p_it_notif y " 

gp_at_ptlnotify 
process_initial_quantum 

r u. V •»• r^. .-, , , c ! gv integrationfftivwiMf-a 

•■7 P,v<-/^-/% T !/ ^Tr / realtime- 10 priorit 



^e>w o^Tun c^ 






Sfspt 



ty^'-''""''/ 
realtime lo aeaaime^ ^.'■ >: 
realtime_io_quantum^ 
hotify_timeout_interval 
not i f y_t imeout_sever i ty 
write limit 



(f 



^T \ T.-s^t 



0.5 seconds 

1. seconds 
8. seconds 
80. seconds 
2, 
20. 

0.5 

0.04 seconds 

offj'^'***' "^^^^^^ 

2. seconds t» s^-^ \o5bpJ 
0. 
4. seconds v-'oI-Kt^s/^j ii^v (jip^^kY/ij 

on opP cieifflwr <*"n>nr;*r,rj. 

0. seconds 
0.005 seconds 
30. seconds 

724 






'2? 



THESE ARE "INTERNAL", NORMALLY NEVER CHANGED, 
IF THE -all CONTROL ARGUMENT IS GIVEN 



AND ONLY PRINTED 



stack_truncation on 

stack_truncation_always off 
stk_trunc_block_avg_f actor 0.25 
trap_invalid_masked off 
meter_ast_locking off 
checksum_f ilemap on 
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TRAFFIC CONTROL COMMANDS 



print apt entry iJil,^0,(.r*f-zr-!H -P<^•£- 



s PRINT_APT_ENTRY - INTERPRETS AND DUMPS AN APT ENTRY 

4p>'i<»i, r«<Tu/> Ti-c-^ cj\^ 



I 



print_apt_entry Sibert -dump 

Sibert.Multics.a b.hl26 at 10300 in tc_data, >pdd> ! BblCpbBbBBBBBB 

PID:010300356001 TRM: 000447007410 407777000460 ^ va;<^.e C^'5 V^ps PO 

Running for 0.067825 (since 01:28:53). 

Usage: cPU 8:40.8; vcpu 6:04.6; pf 23622. 

te/s/i/x": 0.411 0.000*0.647 32.000. 

Flags: loaded, el i gible ,mbzll ,dbr_loaded. 

Alarm in 31.244 (at 01:29:24). 

005400003000 014225000001 000000056106 010300356001 

4 000001443141 000000000000 000002356631 000172044000 

10 000000000000 000000000000 005200013740 000000002076 

14 003000777777 115641364232 000000000000 003702747134 

20 000000000000 001360000002 000000111567 457572337662 

24 000000000000 000000000000 011700111567 457761705103 

30 000447007410 407777000460 000000000000 000001720440 

34 000000111567 457736532472 003322000000 ODOOOOOOOOOO 

40 000000000000 000004325430 000000000000 000000000000 

44 035117540004 001775100023 000000000000 002556711030 

50 000000000000 000000000000 000000000004 000000004441 

54 000000111567 457572506651 000000000000 014274070015 

60 000000000000 002557051053 000001720440 776000000000 

64 000000000000 000000000000 000000000000 000000000000 

70 000000000000 000000000000 000000000000 000000000000 

74 000000000000 000000000000 000000000000 000000000000 



Not To Be Reproduced 9-28 F80A 

(End Of Topic) 



TOPIC X 
•Fault and Interrupt Handling 
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FAULT AND INTERRUPT HANDLING OVERVIEW 



s FUNCTION 



RESPONSIBLE FOR HANDLING ALL EXCEPTIONS IN A CPU WHETHER 
INTERNAL TO THE PROCESSOR (REFERRED TO AS FAULTS ) OR EXTERNAL 
(REFERRED TO AS INTERRUPTS) 



ESTABLISHES THE SUPERVISOR ENVIRONMENT AT FAULT AND INTERRUPT 
TIME. SAVES THE MACHINE CONDITIONS AND TRANSFERS TO THE 
APPROPRIATE HANDLER 



MAJOR COMPONENTS: THE FAULT INTERCEPT MODULE (fim), WI RED-FAULT 
INTERCEPT MODULE (wired_fim), I/O INTERRUPT HANDLER 
(io_interrupt) , sys_trouble, page_fault 



B MAJOR DATA BASES 



INTERRUPT VECTORS - ONE SET PER SYSTEM (WIRED) 



INTERRUPT PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED 
INTERRUPT TYPE 



LOCATED AT ABSOLUTE ADDRESS 0. A HARDWARE RECOGNIZED DATA 
BASE 



DESCRIBE WHERE TO SAVE THE CONTEXT, AND WHERE TO TRANSFER TO 
TO PROCESS THE INTERRUPT (ALWAYS io_interrupt ) 
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FAULT AND INTERRUPT HANDLING OVERVIEW 



1 FAULT VECTORS - ONE SET PER SYSTEM (WIRED) 

B VECTOR PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED FAUL"] 
TYPE 



LOCATED AT ABSOLUTE ADDRESS 100 (OCTAL) IMMEDIATELY ABOVE THE 
INTERRUPT VECTORS. A HARDWARE RECOGNIZED DATA BASE 



DESCRIBE WHERE TO -SAVE THE CONTEXT, AND WHERE TO TRANSFER TO 
TO PROCESS THE FAULT (fim, wired_fim, page_fault) 



PROCESS DATA SEGMENT (PDS) - ONE PER PROCESS (WIRED WHEN 
ELIGIBLE) ~ 



CONTAINS PROCESS RELEVANT INFO SUCH AS PROCESS ID, USER ID, 
HOME /WORKING/PROCESS DIRECTORIES, AIM CLASSIFICATION, INITIAL 
RING, ETC 



CONTAINS ALL INFORMATION ABOUT THE PROCESS NEEDED BY THE 
SUPERVISOR CODE WHEN THE PROCESS IS RUNNING 



CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH CAN RESULT IN GIVING UP THE PROCESSOR: PAGE FAULTS, 
SEGMENT FAULTS, AND ALL FAULTS NOT HANDLED BY THE SUPERVISOR 



C PROCESSOR DATA SEGMENT ( PRO S ) - ONE PER CONFIGURED CPU (WIRED) 

SERVES AS RING- ZERO STACK FOR PAGE CONTROL AND TRAFFIC 
CONTROL 



D ALSO CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH USUALLY, DO NOT MEAN GIVING UP THE PROCESSOR: CONNECT 
FAULTS AND INTERRUPTS. 
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FAULT AND INTERRUPT HANDLING OVERVIEW 



i FIM_TABLE 



A TABLE IN THE FIM PROGRAM WHICH DESCRIBES THE ACTION TO BE 
TAKEN FOR VARIOUS TYPES OF FAULTS 
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FAULT AND I NTERRUPT DATA BASES 
FAULT AND INTERRUPT VECTORS 



K ALL FAULTS AND INTERRUPTS ARE HANDLED IN A CENTRALIZED FASHION 



FOR EACH FAULT OR INTERRUPT, THERE ARE TWO INSTRUCTIONS: 

I AN scu INSTRUCTION, TO STORE THE ABSOLUTELY ESSENTIAL DATA 
NEEDED TO RESTART FROM THE FAULT 

I A tra INSTRUCTION, TO TRANSFER TO TO THE APPROPRIATE FAULT 
HANDLER 



I ASSOCIATED WITH EACH OF THESE INSTRUCTIONS, THERE IS A POINTER 

AN SCU DATA POINTER, POINTING TO ONE OF SIX REGIONS WHERE 
FAULT DATA GOES 

5 A FAULT HANDLER POINTER, INDICATING ONE OF THE PROCEDURES 
USED TO HANDLE FAULTS 



THESE INSTRUCTIONS AND POINTERS ARE STORED IN THE fault_vector 



THE DATA STORED ' BY SCU IS ONLY THE "CONTROL UNIT DATA" - EACH 
HANDLER MUST IMMEDIATELY SAVE THE PROGRAM VISIBLE REGISTERS, THE 
EIS POINTER & LENGTH DATA, AND SO FORTH. THIS DATA IS ALWAYS 
STORED IN THE SAME FORMAT, THE MACHINE CONDITIONS STRUCTURE 
(mc . incl .pll ) 
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FAULT AND INTERRUPT DATA BASES 



FAULT AND- INTERRUPT VECTORS 




lfMilt_wacBw.-ind.pl1 ) 



FAULT AND irfTERRUPT VECTORS 

A HARDWARE RECOGNIZED DATA BASE LOCATED 
AT ABSOLUTE ADDRESS 577 
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FAULT AND INTERRUPT DATA BASES 



FAULT DATA SAVE AREAS 



B THERE ARE SIX REGIONS WHERE MACHINE CONDITIONS ARE STORED, 



THEY ARE SELECTED TO MINIMIZE THE NUMBER OF TIMES WHEN FAULT 
DATA MUST BE MOVED. USUALLY, ONCE FAULT DATA HAS BEEN STORED IN 
A PARTICULAR PLACE, IT CAN BE RESTORED DIRECTLY FROM THERE, BUT 
SOMETIMES IT MUST BE MOVED TO ANOTHER PLACE 



D prds$interrupt_data - USED FOR INTERRUPTS, ONLY 

B prds$f iin_data - USED FOR FAULTS SUCH AS CONNECT FAULTS, WHICH 
WILL BE HANDLED ENTIRELY USING THE WIRED RING ZERO STACK 
( PRDS ) 

prds$sys_trouble_data - USED FOR THE FAULT THAT CRASHED THE 
system; NO MACHINE CONDITIONS ARE EVER STORED HERE DIRECTLY, 
ONLY MOVED HERE. 



Dds$f im_data - USED FOR FAULTS WHICH WILL BE HANDLED IN RING 
ZERO, USING THE RING ZERO STACK, WHERE PAGE FAULTS MIGHT BE 
TAKEN WHILE THE OTHER FAULT IS BEING HANDLED 



pds$Dage_fault_data - USED FOR PAGE FAULTS AND TIMER RUNOUTS 
(WHICH INDICATE THE END OF A QUANTUM) - BOTH ARE EVENTS WHICH 
ALMOST ALWAYS RESULT IN GIVING UP THE PROCESSOR, BUT WHICH 
ARE HANDLED ON THE WIRED RING ZERO STACK (PRDS) 



pds$signal_data - USED FOR FAULTS. WHICH WILL BE SIGNALLED OUT 
FOR THE USER RING TO HANDLE. IF AN ERROR OCCURS PROCESSING 
SOME FAULT IN RING ZERO, ITS' FAULT DATA IS MOVED HERE BEFORE 
SIGNALLING 



THERE ARE ALSO SPECIAL STACK FRAMES CREATED BY THE FIM USED FOR 
FAULT SIGNALLING, AND THE MACHINE CONDITIONS ARE COPIED THERE. 
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FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



CERTAIN FAULTS DESERVE SPECIAL DISCUSSION, AS THEI ARE USED TO 
IMPLEMENT IMPORTANT SUPERVISOR SERVICES 



LINKAGE FAULT 

OCCUR WHEN A POINTER CONTAINING 46 OCTAL IN THE LOW SIX BITS 
OF THE FIRST WORD IS USED 

USED TO IMPLEMENT DYNAMIC LINKING (SEE NAME/ADDRESS SPACE 
MANAGEMENT, TOPIC 4) 

USES pds$fiin_data, IS HANDLED BY fim.alm, WHICH INVOKES 
link_man.pll, HANDLED ENTIRELY ON THE stack_0 



SEGMENT FAULT 



OCCURS WHEN AN NON-ACTIVE SEGMENT IS REFERENCED (SEE SEGMENT 
CONTROL, TOPIC 7) 



USES pds$fim_data, IS HANDLED BY fim.alm, WHICH INVOKES 
seg_fault.pll, HANDLED ENTIRELY ON THE stack_0 



A SEGMENT FAULT MAY OCCUR WHILE ANOTHER IS BEING HANDLED, AND 
IT WILL BE HANDLED RECURSIVELY 



PAGE FAULT 



OCCURS WHEN A PAGE NOT IN MEMORY IS REFERENCED (SEE PAGE 
CONTROL, TOPIC 8) 
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FAULT AND INTERRUPT DATA BASES 
IMPORTANT TYPES OF FAULTS 



USES pds$page_fault_data, IS HANDLED DIRECTLY BY 
page_fault.alm, AND IS HANDLED ENTIRELY ON THE PRDS. 

I TIMER RUNOUT ^v^d^ \y^i'^> 

O OCCURS WHEN THE TIMER REGISTER IS DECREMENTED THROUGH ZERO, 
INDICATING THAT THE RUNNING PROCESS HAS NOW OVERSTAYED ITS 
WELCOME, AND SHOULD LOSE ELIGIBILITY 

D TIMER RUNOUT FAULTS ARE ALSO USED INTERNAL TO TRAFFIC 
CONTROL TO IMPLEMENT "PRE-EMPT" SAMPLING; IN THIS MODE, 
NOW THE DEFAULT, THE TIMER GOES OFF EVERY FEW MILLISECONDS 
AND THE PROCESS CHECKS TO SEE WHETHER A HIGHER PRIORITY 
PROCESS WANTS THE PROCESSOR; THIS DOES NOT MAKE THE 
.RUNNING PROCESS INELIGIBLE, HOWEVER, UNLESS ITS QUANTUM 
HAS ALSO RUN OUT 

I A PROCESS RUNNING IN RING ZERO NEED NEVER GIVE UP 
ELIGIBILITY - WHEN A TIMER RUNOUT HA-PPENS , IT REMEMBERS, 
AND SETS THE RING ALARM REGISTER, WHICH WILL CAUSE A RING 
ALARM FAULT LATER ON WHEN IT LEAVES RING ZERO 

USES pdsspaqe_fault_data, IS HANDLED DIRECTLY BY pxss.alm, 
AND is" HANDLED ENTIRELY ON THE PRDS. 



H RING ALARM FAULT 

D OCCURS WHEN A PROCESS RETURNS TO AN OUTER RING FROM AN INNER 
RING, AND THE RING ALARM REGISTER HAS BEEN SET 

i (1) USED TO DEFER ACTION ON TIMER RUNOUTS AND CONNECT FAULTS 
(SEE BELOW) UNTIL A PROCESS LEAVES RING ZERO 

D (2) USED TO ENSURE THAT THE SOFTWARE VALIDATION LEVEL (SET 
WITH cu_$level_set) IS NEVER LOWER THAN THE RING OF EXECUTION 
- SETTING THE VALIDATION LEVEL ALSO SETS THE RING ALARM 
REGISTER, AND THE RING ALARM FAULT CAUSES THE VALIDATION 
LEVEL TO BE RESET 
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FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



USES pds$page_fault_data, IS HANDLED DIRECTLY BY 
ring_alarm.alin AND IS HANDLED ENTIRELY ON THE PRDS. 

1 IS ACTUALLY A SUBTYPE OF ACCESS VIOLATION 

CONNECT FAULT C.^^V-..^,.. .0^7.... ^^^j^ f"'"/ A f J^^^ 
CONNECT FAULT ' f^c^^^^-j . f^.f^^M U^^ ^^^\ ^^^ C^^^^p/ 

\ OCCURS WHEN ONE PROCESSOR SENDS A "connect" TO ANOTHER, USING 
A cioc INSTRUCTION 

■ RESEMBLES A SOFTWARE SENDABLE INTERRUPT; ALTHOUGH 
PROCESSORS CAN SEND INTERRUPTS TO EACH OTHER, LIMITATIONS 
OF THE HARDWARE MAKE CONNECT FAULTS EASIER TO USE 



USED FOR ALL INTERPROCESSOR SIGNALLING - 

I (1) TO CAUSE ANOTHER PROCESSOR TO SELECTIVELY CLEAR ITS 

(2) TO PRE-EMPT A PROCESS RUNNING ON ANOTHER CPU (WHEN 
PRE-EMPT SAMPLING IS NOT IN USE) 

fl (3) TO INFORM ANOTHER PROCESSOR THAT THE SYSTEM IS 
CRASHING 

D (4) TO INFORM ANOTHER PROCESSOR THAT IT IS BEING REMO\^D 
FROM THE CONFIGURATION 

USES prds$f im_data, IS SOMETIMES HANDLED BY wired_f im.alm, 
AND IS HANDLED ENTIRELY ON THE PRDS. 

B FOR TYPE 1 CONNECTS (CACHE CLEAR), THE FAULT IS HANDLED 
VERY SPECIALLY BY CODE WHICH IS ACTUALLY EXECUTED FROM 
WITHIN THE PRDS (SEE f ast_connect_init .aim} , AND RUNS 
SOMEWHAT FASTER. THE COMPLICATED CASES ARE LEFT TO 
WIRED_FIM , _ f ^ ri. r ' v 

CELLS IN THE scs. ARE USED TO DISTINGUISH BETWEEN THE 
DIFFERENT TYPES OF CONNECT FAULTS; A PROCESSOR SETS THE 
APPROPRIATE CELLS BEFORE SENDING THE CONNECT. 
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FAULT AND INTERRUPT DATA BASES 
IMPORTANT TYPES OF FAULTS 



OTHER FAULTS 



PARITY - RUN AUTOMATIC PARITY ERROR LOGGING AND DIAGNOSIS (TO 
CHIP LEVEL, FOR CACHE) ROUTINES 



OP_NOT_COMPLETE , COMMAND, SHUTDOWN, STARTUP, STORE, TROUBLE - 
RUN HARDWARE ERROR LOGGING ROUTINES 



OVERFLOW, UNDERFLOW - CAN BE SET UP TO 
SPECIFIED (VERY LARGE OR VERY SMALL) 
WITHOUT INTERRUPTING THE RUNNING PROGRAM 



AUTOMATICALLY SET A 
VALUE AND RESTART 



DERAIL - USED WHEN CRASHING THE SYSTEM OR VOLUNTARILY 
RETURNING TO BOS TO BEGIN EXECUTION IN BOS. AN ORDINARY 
SIGNALLABLE FAULT AT ALL OTHER TIMES (AND USED THAT WAY BY 
THE gtss EMULATOR). oi ^^-c $/S^r<^^ -^^ '^o^f^^,f. jot'p/v'.s »/- ko Sc«^ol'K.^^ 

EXECUTE - USED TO FORCE A SYSTEM CRASH 



ACCESS VIOLATION - CAN AUTOMATICALLY 
FOR J^ErURiTY ArTDITS 



LOG ACCESS VIOLATIONS 



OTHERS - HANDLED BY fim.alm, WHICH MAPS THE HARDWARE FAULTS 
ONTO THE MULTICS ENVIRONMENT CONDITION NAMES 

8 CONSIDERABLE INTERPRETATION IS SOMETIMES REQUIRED; FOR 
INSTANCE, A NULL POINTER IS ACTUALLY SIGNALLED BY THE 
HARDWARE AS AN ACCESS VIOLATION, OUT OF BOUNDS ON DSEG , 
FAULT 



I NTERRUPT 



INTERRUPTS ARE USED TO ANNOUNCE THE COMPLETION OF ALL I/O 
OPERATIONS, AND ALSO (RARELY) USED DURING DYNAMIC 
RECONFIGURATION TO START PROCESSORS 



Not To Be Reoroduced 



10-10 



F80; 



FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



USES prds$interrupt__data, IS HANDLED DIRECTLY BY 
iom__interrupt.alm OR init_processor.alm, AND IS HANDLED 
ENTIRELY ON THE PRDS. 
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FAULT /INTERRUPT METERS 
fim meters 



B FIM_METERS - COUNTS FOR ALL FAULT PROCESSING 

Total metering time: 0:20:28 

fault type 'count 

shutdown 

store 

mmel 

fault_tag_l 2 

timer_runout 12907 

command 5 

derail 

lockup 

connect 742501 

parity 

illegal_procedure 

op_not_complete 

startup 

overflow 

divide_check 

execute 

segment_f ault 6697 

page_fault 151772 

directed_fault_2 

directed_fault_5 

access_violation 21120 

mme2 

mme3 

mme4 

linkage_fault 21C58 

fault_tag_3 

trouble 

__^ c ,7-c, ©^a 

I , "i^ ' ' I 
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FAULT/INTERRUPT METERS 
interrupt meters 

s INTERRUPT METERS - COUNTS & TIMING FOR ALL I/O INTERRUPTS 



Toti 


al metering time 0: 


20:28 




lOM Ch 


Int 


Avg Time 


% CPU 


Name 


A 


6. 


11 


2.043 


0.00 


lOM A 


A 


10. 


379 


1.553 


0.01 


prtfa 


A 


13. 


9253 


3.436 


0.65 


fnp c 


A 


14. 


19 


0.788 


0.00 


ope 


A 


16, 


26248 


1.347 


0.72 


tapa 


A 


17. 


128 


1.328 


0.00 


tapa 


A 


18. 


13097 


5.383 


1.43 


fnp b 


A 


20. 


21041 


0.860 


0.37 


dska 


A 


21. 


2881 


0.860 


0.05 


dska 


A 


22. 


8486 


0.877 


0.15 


dskb 


A 


23. 


257 


0.964 


0.01 


dskb 


A 


24. 


17896 


0.895 


0.33 


dskb 


A 


25. 


2573 


0.943 


0.05 


dskb 


A 


26. 


10486 


0.857 


0.18 


dska 


A 


27. 


255 


0.899 


0.00 


dska 


A 


28. 


24717 


0.845 


0.43 


dskc 


A 


29. 


2319 


0.849 


0.04 


dskc 


A 


30. 


9915 


0.845 


0.17 


dskc 


A 


31. 


215 


0.767 


0.00 


dskc 


B 


14. 


236 


0.877 


0.00 


fnp d 


B 


15. 


6917 


3.351 


0.47 


fnp f 


B 


18. 


3547 


3.543 


0.26 


fnp a 


B 


19. 


13667 


3.435 


0.96 


fnp e 


B 


20. 


22013 


0.881 


0.39 


dskb 


B 


21. 


4745 


0.863 


0.08 


dskb 


B 


22. 


6054 


0.861 


0.11 


dska 


B 


23. 


60 


0.925 


0.00 


dska 


B 


24. 


15946 


0.867 


0.28 


dska 


B 


25. 


989 


0.841 


0.02 


dska 


B 


26. 


12757 


0.863 


0.22 


dskb 


B 


27. 


1020 


0.903 


0.02 


dskb 


B 


28. 


5178 


0.838 


0.09 


dskc 


B 


29. 


30 


0.653 


0.00 


dskc 


B 


30. 


• 16582 


0.823 


0.28 


dskc 


B 


31. 


825 


0.841 


0.01 


dskc 


B 


32. 


1764 


0.825 


0.03 


dske 


Cha 


n 


262506 


1.464 . 


7.82 




Ovhd 


258932 


0.230 


1.-21 




Tot 


al 


258932 


1.713 


9.03 





special 



Not To Be Reproduced 



10-13 
(End Of Topic) 



F80A 



TOPIC XI 
System Initialization/Shutdown 
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SYSTEM INITIALIZATION OVERVIEW 



8 FUNCTION 



PREPARE THE SYSTEM TO OPERATE, STARTING FROM A COMPLETELY EMPTY 
MACHINE 



READS IN SUPERVISOR PROGRAMS FROM SYSTEM TAPE, SNAPS LINKS 
BETWEEN SUPERVISOR COMPONENTS, VERIFIES AND INITIALIZES HARDWARE 
CONFIGURATION, SETS UP SYSTEM DATABASES, ACCEPTS STORAGE SYSTEM 
DISKS AND PREPARES THEM FOR USE BY THE FILE SYSTEM 



MOST PROGRAMS IN SYSTEM INITIALIZATION ARE DELETED AFTER 
INITIALIZATION IS COMPLETE. 



SUPERVISOR PROGRAMS ARE LOADED IN THREE "COLLECTIONS", EACH OF 
WHICH DEPENDS ON THE MECHANISMS SET UP BY THE PREVIOUS ONE 



B MAJOR DATA BASES 



THESE DATA BASES ARE ALL BUILT DURING THE PROCESS OF 
INITIALIZATION (EXCEPT FOR THE CONFIG DECK) AND KEPT AFTER 
INITIALIZATION IS FINISHED 



fl SEGMENT LOADING TABLE (>sll>slt) 

CONTAINS AN ENTRY DESCRIBING THE ATTRIBUTES OF EACH SEGMENT 
IN THE SUPERVISOR 
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SYSTEM INITIALIZATION OVERVI EW 



I NAME TABLE (>sll>nanie_table ) 

CONTAINS A LIST OF NAMES FOR EACH OF THE SEGMENTS IN THE 
SUPERVI SOR 



B DEFINITIONS SEGMENT ( >sll>def initions_) 

CONTAIl^S THE DEFINITIONS SECTIONS FOR ALL THE SEGMENTS IN THE 
SUPERVISOR, WHICH ARE USED IN ORDER TO SNAP LINKS BETWEEN THE 
SUPERVISOR MODULES 



[ CONFIG DECK (>sll>conf ig_deck ) 

B CONTAINS A DESCRIPTION OF THE HARDWARE CONFIGURATION AND 
CERTAIN SOFTWARE PARAMETERS 

O PROVIDED TO SYSTEM INITIALIZATION BY BOS 



SHUTDOWN — TERMINATES THE ACTIVITIES OF THE SYSTEM IN AN ORDERLY 
FASHION 



D TWO TYPES OF SHUTDOWN: 

D NORMAL — REQUESTED BY THE INITIALIZER, RUNS IN THE USUAL 
SUPERVISOR ENVIRONMENT 

I EMERGENCY ~ USED AFTER A CRASH, MUST MiAKE THE SUPERVISOR 
ENVIRONMENT OPERABLE BEFORE PROCEEDING 
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SYSTEM INITIALIZATION OVERVIEW 



BOTH TYPES EXIST PRIMARILY TO SHUT DOWN THE FILE SYSTEM — THAT 
IS. TO WRITE ALL DATA IN MEMORY INTO ITS PROPER HOME ON DISK 



INCLUDES PAGES OF SEGMENTS, VTOCES , VOLUME AND VTOC MAPS 



SHUTDOWN ESSENTIALLY RUNS THE STEPS OF INITIALIZATION BACKWARDS, 
BUT WITH A LOT OF SHORTCUTS 
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SYSTEM INITIALIZATION TERMINOLOGY 

CONFIG DECK: A SET OF CARDS OR CARD IMAGES USED TO INFORM THE 
SOFTWARE ABOUT THE OPERATIONAL READINESS OF THE 
HARDWARE PRESENT, SWITCH SETTINGS AND SPECIFICATIONS OF 
SOME SOFTWARE DATA BASES (SIZE, LOCATION, ETC) 



BOS: THE BOOTLOAD.. OPERATING SYSTEM. A SIMPLE OPERATING 

SYSTEM (A ONE CPU, UNPAGED ENVIRONMENT) OF 8 SEGMENTS 
OCCUPYING THE FIRST-16K OF MAIN MEMORY. BOS RESIDES IN 
THE BOS PARTITION WHEN "MULTICS" IS RUNNING 



MST: THE MULTICS SYSTEM TAPE CONTAINS PRECISELY ENOUGH 

INFORMiATION (PROCEDURES AND DATA BASES) TO BRING A BARE 
HARDWARE SYSTEM TO MULTICS COMMAND LEVEL (ACTUALLY, 
ONLY ENOUGH OF COMMAND LEVEL TO PERFORM A RELOAD) 



BOOT: THE OPERATIONAL PROCEDURE OF READING THE SEGMENTS FROM 

THE MST AND EXECUTING THE PROCEDURE/SEGMENTS THEREIN 



WARM /COLD BOOT: 

BOOTING THE SYSTEM WITH /WITHOUT A HIERARCHY PRESENT 



HARDCORE PARTITION: 

A RLV PARTITION FOR PAGING HARDCORE SEGMENTS CREATED 
DURING BOOTLOAD 
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SYSTEM INITIALIZATION TERMINOLOGY 

DECIDUOUS SEGMENT: 

A SEGMENT READ IN AS PART OF THE BOOTLOAD TAPE AND 
PLACED INTO THE HIERARCHY. DECIDUOUS SEGMENTS ARE PART 
OF THE INITIALIZER'S HARDCORE ADDRESS SPACE AND RESIDE 
ENTIRELY IN THE HARDCORE PARTITION, THEY ARE PUT INfO 
THE HIERARCHY {>sll) IN ORDER TO BE ACCESSIBLE FROM THE 
USER RINGS 



NON DECIDUOUS HARDCORE SEGMENT: 

A PAGED HARDCORE SEGMENT NOT IN THE HIERARCHY (AND THUS 
HAS NO PATHNAME) 
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ORDINARY SEGMENTS: 
>sss>bound_pi1_ 

> udd > M E D > Kaiser > Kaiser.mbx 

> udd >Site Sa >Homan >test_pn 
fpd] > stack_4 


NON-SUPERVISOR 

» 


HIERARCHY 


ALL 

OTHER 

SEGMENTS 


DIRECTORY SEGMENTS: 
■> udd > udd >Site Sa 
>sss >udd>MED 


REVERSE-DECIDUOUS: 
{per-proces<;,per-bootioad, ring only) 
[pd}>dseg >sl1 >stack_0.nnn 
ipd]>kst 
lpd]>pds 


LU 

LU 
CD 


COLLECTION 

#3 


NON-SUPERVISOR PROGRAMS: 

> sll > bound_command_loop_ 

> sll > bound_rcp_ 


O 
2 
< 

o" 

z 
o 

u 
111 

_i 
_J 
o 
u 


DECIDUOUS: 

> sll > bound_sss_wired_ 

> sll >sys_info 

> sll >hcs_ (all ring gates) 


PERMANENT SUPERVISOR AND 
INITSEGS 


DISK OVERLAY ABS-SEGS: 

volmap_abs_seg 

syserr_log 


>- 

X 

o 

< 
or 

LU 

X 

t 

o 

z 


NON-DECIDUOUS PAGED: 
bound_file_system 
bound_syst6m_faults 
str_seg 


UNPAGED: 

sst_seg tc_data 

pxss 

bound_page_cotnroi 

bound_to_wired 



CO 
UJ 

q: 
o 
o 

LU 

H 
< 



UJ 

O 

UJ 

en 
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INITIALIZATION DATA BASES 



THE TERM INITIALIZATION REFERS TO THE ACTIONS REQUIRED TO CREATE 
THE MULTICS ENVIRONMENT GIVEN THE EXISTENCE OF A CONFIGURATION 
DECK, AND HARDWARE CONTAINING NO OTHER DATA THAN FIRMWARE AND BOS 



INITIALIZATION IS ACCOMPLISHED BY AN ORDERLY LOADING AND PROCESSING 
OF THE SEGMENTS RESIDING ON THE MULTICS SYSTEM TAPE (MST) 



B THE SEGMENTS OF THE MST MAY BE DIVIDED INTO THREE CATEGORIES: 



INITIALIZATION SEGMENTS 



PROCEDURES USED ONLY FOR INITIALIZATION AND SUBSEQUENTLY 
DISCARDED 



SUPERVISOR SEGMENTS 



D DATA BASES USED DURING INITIALIZATION THAT ULTIMATELY BECOME 

DATA BASES OF Initializer .SysDaemon. 2 

B PROCEDURES AND DATA BASES THAT CONSTITUTE MULTICS HARDCORE 

SUPERVISOR IN ITS ENTIRETY 



D NON-SUPERVISOR SEGMENTS 



THE SEGMENTS OF COLLECTION THREE ARE PRECISELY THE 

NON-SUPERVISOR SEGMENTS OF THE MST. THESE SEGMENTS ARE 

LOADED DIRECTLY INTO >systeni_library_l , AND ARE NOT PART OF 
THE RING ZERO SUPERVISOR 
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INITIALIZATION DATA BASES 



B BOOTLOAD PROCESSOR 



ONE PROCESSOR (THE BOOTLOAD CPU) PERFORMS ALL OF INITIALIZATION 
RUNNING EXCLUSIVELY IN RING ZERO 



IN THE MOST OF INITIALIZATION (COLLECTION ONE AND MOST OF 
COLLECTION TWO), THERE ARE NO PROCESSES, AS SUCH. THE 
ENVIRONMENT WHICH RUNS THERE EVENTUALLY BECOMES THE 
Initializer. SysDaemon PROCESS 



NOTE: SINCE THE Initializer . SysDaemon DOES NOT LOGIN LIKE OTHER 
USERS, IT DOES NOT APPEAR IN THE NORMAL USER TABLE, CONSEQUENTLY 
IS NOT VISIBLE TO THE who COMMAND 



B STRATEGY OF INITIALIZATION: BOOTSTRAPPING 



THE FIRST PROCEDURES RUN IN ' AN ENVIRONMENT DEVOID OF ALL 
SOFTWARE ASSISTANCE 



EACH NEW MECHANISM (SEGMENTATION, STACKS, SYMBOLIC LINKING, 
PAGING, ETC) IS MADE OPERATIVE AS SOON AS POSSIBLE TO ENRICH THE 
ENVIRONMENT IN WHICH FURTHER MECHANISMS ARE MADE OPERATIVE 



MANY MECHANISMS HAVE SUBSYSTEMS THAT CONTROL THEM AND THESE 
SUBSYSTEMS ARE NORMALLY INITIALIZED BY CALLING A SPECIAL ENTRY 
POINT IN THE SUBSYSTEM WHICH PERFORM SUCH TASKS AS: 

D CREATING TABLES WHOSE SIZES ARE DETERMINED BY DATA SPECIFIED 
IN THE "CONFIG" DECK 



il THREADING OF RELEVANT LISTS 



Not To Be Reproduced . 11-8 FSOA 



INITIALIZATION DATA BASES 



SEGMENTS ON THE MST ARE ARRANGED IN SUCH AN ORDER THAT THE 
EARLIER SEGMENTS ALLOW AS MANY MECHANISMS AS POSSIBLE TO BE USED 
IN LOADING AND PROCESSING OF THE LATER SEGMENTS 



FOR THIS PURPOSE (AND BECAUSE THE SIZE OF THE MST IS POTENTIALLY 
LARGER THAN MAIN MEMORY), THE MST IS DIVIDED INTO FOUR PARTS 
KNOWN AS COLLECTION ZERO, ONE, TWO AND THREE 



I INITIALIZATION CAN BE VIEWED AS THE LOADING AND PROCESSING OF 
COLLECTION ONE, COLLECTION TWO, AND COLLECTION THREE, IN TURN 



THE ADDRESS SPACE OF INITIALIZATION {MINUS THE INITIALIZATION 
SEGMENTS) BECOMES THE GLOBAL SUPERVISOR ADDRESS SPACE OF MULTICS 



SPACE OF NEWLY CREATED PROCESSES BY DUPLICATING THE DSEG 



Not To Be Reproduced 11-9 F80A 



ENVIRONMENT PASSED TO INITIALIZATION 



s THE FIRST SEGMENT OF COLLECTION ONE IS THE BOUND SEGMENT 
bound bootload 1 



AT THE TIME CONTROL IS TRANSFERRED TO bound_bootload_l , IT IS 
REQUIRED THAT BOS HAS INITIALIZED MAIN MEMORY AS FOLLOWS: 



THE lOM MAILBOX MUST BE AT LOCATION 1400 AND CONTAIN THE CHANNEL 
AND DEVICE NUMBER OF THE TAPE DRIVE ON WHICH THE MST IS MOUNTED 



THE CONFIG DECK (AS PRODUCED BY BOS) MUST RESIDE AT LOCATION 
14000 THRU 15777 



I THE BOS TOEHOLD AND FLAGBOX MUST BE AT LOCATION 10000 THRU 11777 

D THIS ONE PAGE CONSTITUTES ALL KNOWLEDGE THAT MULTICS HAS OF 
BOS 

D TRANSFERRING CONTROL TO THE START OF THE BOS TOEHOLD WILL 
CAUSE : 

D FIRST 64K OF MAIN MEMORY TO BE FLUSHED OUT TO THE BOS 
PARTITION 

I THE BOS OPERATING SYSTEM TO BE READ INTO THE FIRST 64K OF 
MAIN MEMORY 

J CONTROL GIVEN TO BOS 
B THE REMAINDER OF MAIN MEMORY MUST CONTAIN ZEROES 
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COLLECTION 



THIS CONSISTS OF THE SEGMENTS WHICH ARE DEFINED TO BE PRESENT IN 
THE INITIAL ADDRESS SPACE 



THESE SEGMENTS ARE EMPTY, AND OVERLAY SPECIFIC REGIONS OF MAIN 
MEMORY. THEY ARE DEFINED SO THAT bound bootload 1 CAN KNOW WHAT 
SEGMENT NUMBERS TO USE FOR WHAT DATA 



fl THE COLLECTION ZERO SEGMENTS ARE dseg, fault_vector, 
iom_mailbox, config_deck, dn355_mailbox, bos_toehold, flagbox, 
sit, and name_table 

SEE SECTION 5, NAME / ADDRESS SPACE MANAGEMENT, FOR THEIR 
DESCRIPTIONS 
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COLLECTION 1 



COLLECTION 1 CONTAINS ALL OF THE PROCEDURES AND DATA BASES 
NECESSARY TO MAKE PAGING OPERATIVE 



B BASIC STEPS OF COLLECTION 1 LOADING AND INITIALIZATION: 

I bound_bootload_l GAINS CONTROL FROM BOS, IN ABSOLUTE MODE, AND 
PERFORMS THE FOLLOWING: 

B LOADS THE REMAINDER OF ITSELF INTO MAIN MEMORY 

ESTABLISHES INTERIM FAULT AND INTERRUPT VECTORS 

INITIALIZES THE INITIALIZATION DSEG , AND ENTERS APPENDING 
MODE 

1 READS THE REMAINDER OF COLLECTION 1 INTO MAIN MEMORY 
(INCLUDING A SEGMENT NAMED bootstrap2) 

bound_bootload_l TRANSFERS TO bootstrap2 

C bootstrap2 PERFORMS THE FOLLOWING: 

CREATES A STACK FRAME IN THE SEGMENT "inzr_StkO" 

D CALL THE APPROPRIATE PROCEDURES TO PRELINK THE SEGMENTS OF 
COLLECTION 1 

1 SETS UP THE PL/I ENVIRONMENT AND CALLS THE FIRST PL/I 
PROCEDURE "initializer" 
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COLLECTION 1 



initializer (A SUPERVISOR SEGMENT), ACTUALLY CALLS 
real_initiali2er TO DO THE REAL WORK. ALL THE REST OF 
INITIALIZATION TAKES PLACE VIA CALLS IN real initializer 



jj rO« 



DEBUGGING PURPOSES, rriERE IS A MECHANISM IN 
real_initializer WHICH CAN BE USED TO STOP AT ANY OF THOSE 
CALLS BY SETTING A VALUE IN THE PROCESSOR SWITCHES 



THE MAJOR INITIALIZATIONS 
ONE ARE: 



PERFORMED IN THE REST OF COLLECTION 



INITIALIZE THE SCU, CLOCK, AND CPU CONTROL MECHANISMS, 
CHECKING THE SWITCHES AND THE ADDRESSABILITY OF MEMORY 



INITIALIZE FAULT AND INTERRUPT PROCESSING. 
CONSOLE AND SYSERR MECHANISMS 



INITIALIZE THE 



INITIALIZE PRIMITIVE TRAFFIC CONTROL (WAIT 
EVENTS). INITIALIZE THE SST 



FOR SINGLE 



INITIALIZE AND CHECK THE DISK CONFIGURATION. AT THIS POINT, 
IT BECOMES POSSIBLE TO TAKE PAGE FAULTS, AND ALL FURTHER DISK 
I/O IS DONE BY PAGING 



CHECK THE ROOT VOLUMES SPECIFIED ON THE ROOT CARD, AND 
INITIALIZE THE HARDCORE PARTITION MECHANISM. THIS ALSO 
INCLUDES CREATING THE PARTITIONS AND VTOC IN A COLD BOOT 



MAKE SEGMENTS PAGED ~ AT THIS POINT, ALL PAGED SUPERVISOR 
SEGMENTS ARE COPIED INTO THE HARDCORE PARTITION, AND ACCESSED 
BY THE NORMAL PAGE FAULT MECHANISM. COLLECTION ONE ENDS HERE 
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COLLECTION 2 



E COLLECTION TWO - THE REST OF SUPERVISOR INITIALIZATION 



READ IN THE REST OF THE SUPERVISOR SEGMENTS FROM TAPE AND 
INITIALIZE THE REST OF THE SUPERVISOR DATABASES 



WHEN COLLECTION TWO IS FINISHED, THE INITIALIZATION ENVIRONMENT 
HAS BECOME Initializer PROCESS, AND IT CALLS OUT TO RING ONE TO 
START OP THE ANSWERING SERVICE 



D THE FOLLOWING MAJOR STAGES TAKE PLACE IN COLLECTION TWO: 

I COLLECTION TWO IS READ FROM TAPE (STILL USING A SPECIAL 
PROCEDURE, tape_reader, WHICH DOUBLE-BUFFERS) 

[ THE AND CONDITION SIGNALLING AND HIGHER LEVEL FAULT 
MECHANISMS ARE INITIALIZED 

I HIGH LEVEL FILE SYSTEM MECHANISMS ARE INITIALIZED: THE VTOC 
MANAGER, VOLUME DUMPER BIT MAP, SCAVENGER, SEGMENT TRAILERS, 
LOGICAL VOLUME MANAGEMENT; DIRECTORY LOCKING 

I TRAFFIC CONTROL IS FURTHER INITIALIZED, AND AN IDLE PROCESS 
IS CREATED FOR THE RUNNING CPU 

I SYSERR LOGGING (TO THE SYSERR PARTITION) IS INITIALIZED. ALL 
SYSERR MESSAGES GENERATED AFTER THIS POINT WILL GO IN THE LOG 

I THE FILE SYSTEM ON THE RPV IS "ACCEPTED", AND THE ROOT 
DIRECTORY INSPECTED (OR CREATED, IF THIS IS A COLD BOOT) 

D AFTER THIS POINT, THE CONTENTS OF THE HARDCORE PARTITIONS 
ARE FIXED, AND ALL FURTHER RECORD ALLOCATION AND FREEING 
IS DONE FROM THE PAGING REGIONS OF THE FILE SYSTEM VOLUMES 
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COLLECTION 2 



DECIDUOUS SEGMENTS ARE SPLICED INTO THE HIERARCHY 



STACK SHARING IS INITIALIZED 



THE REST OF THE SEGMENTS, COMPRISING COLLECTION THREE, ARE 
READ, DIRECTLY INTO THEIR PLACES IN THE HIERARCHY {>sll) 



THE USER VISIBLE SUPERVISOR I/O MECHANISM (ioi) IS 
INITIALIZED, AND THE SPECIAL SUPERVISOR TAPE READER IS SHUT 
DOWN 



TRAFFIC CONTROL IS FULLY INITIALIZED BY CREATING IDLE 
PROCESSES FOR THE OTHER CPUS AND STARTING THEM 



ALL INITIALIZATION SEGMENTS ARE NOW DISCARDED, AND WHAT HAS 
BECOME THE Initializer .SysDaemon PROCESS CALLS init_proc AND 
BEGINS EXECLTION IN RING ONE 



n. 1 inxo fOxiNi, our-Cin v i. sun i jNi. i j. aijx ^aixON xo c i i\ i onciij 
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COLLECTION 3 



COLLECTION THREE IS NOT PROPERLY A "COLLECTION" AT ALL, BUT JUST A 
TERM USED TO DESCRIBE THE BEGINNING OF Initializer AND ANSWERING 
SERVICE INITIALIZATION 



MANY THINGS HAPPEN BETWEEN FIRST LEAVING RING ZERO AND LOGGING 
IN THE FIRST USER. MOST HAVE NOTHING TO DO WITH THE FILE 
SYSTEM. THE FEW MOST INTERESTING ONES ARE: 



VOLUME ACCEPTANCE - THE NON-ROOT VOLUMES ARE INSPECTED AND 
ACCEPTED INTO THE HIERARCHY. THEIR CONFIGURATION CAN BE 
CHANGED BY USE OF OPERATOR COMMANDS 



delete_old_Ddds - THE PROCESS DIRECTORY AND DECIDUOUS 
SEGMENTS LEFT OVER FROM THE PREVIOUS BOOTLOAD(S) ARE DELETED 

B THIS MUST BE DONE AFTER THE HIERARCHY IS. FULLY AVAILABLE, 
SINCE NON-RLV VOLUMES MAY HAVE BEEN USED FOR PROCESS DIRS 



VOLUME SCAVENGER AND QUOTA SALVAGER PROCESSES MAY BE STARTED 
AT THIS TIME, IF THERE ARE INCONSISTENCIES IN THE HIERARCHY 
CAUSED BY PREVIOUS CRASHES 
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NORMAL SHUTDOWN 



a WHEN THE SYSTEM IS SHUT DOWN, IT MUST BE DONE IN AN ORDERLY MANNER 



I THIS IS ACCOMPLISHED, MORE OR LESS, BY RUNNING THE STEPS IN 
I NI TI ALI Z ATI ON BACKWARDS : 



CRAWLOUTS ARE DISABLED. ONCE SHUTDOWN BEGINS, IT CAN'T BE 
STOPPED 



B THE Initializer SWITCHES TO RUNNING ON THE BOOTLOAD CPU, 
TRAFFIC CONTROL IS DISABLED, AND THE * OTHER CPUS ARE STOPPED 
AND DELETED. 

LOCKING IS DISABLED AT THIS POINT, SINCE THERE IS NOW ONLY 
ONE PROCESS AND ONE PROCESSOR RUNNING 



ALL THE DISK DRIVES ARE EXERCISED, TO DETERMINE IF ANY ARE 
BROKEN AND CANNOT BE SHUT DOWN 



ANY VOLUME SCAVENGES IN PROGRESS ARE STOPPED AND ABANDONED 



AT THIS POINT, NORMAL SHUTDOWN IS READY TO SHUT DOWN THE FILE 
SYSTEM, AND ALL THE NORMAL MECHANISMS ARE ASSUMED TO BE 
OPERATING. 



THE Initializer SWITCHES TO in2r_stkO (WHERE IT ALL STARTED) AND 
CALLS shutdown_f ile_system 
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FILE SYSTEM SHUTDOWN 



FILE SYSTEM SHUTDOWN CONSISTS OF FORCING ALL DATA OUT OF MEMORY TO 
ITS HOME ON DISK: 



I ALL PAGES ARE WRITTEN 

I SEGMENTS ARE DEACTIVATED, AND THEIR VTOCES UPDATED 

VOLUMES ARE DEMOUNTED, AND THEIR LABELS UPDATED 

1 FILE SYSTEM SHUTDOWN TAKES THE FOLLOWING STEPS: 

I ALL MODFIED PAGES ARE WRITTEN TO DISK. THIS IS DONE SEVERAL 
TIMES DURING THE COURSE OF SHUTDOWN 

1 STACK_0 SEGMENTS ARE DEACTIVATED AND DISCARDED 

I THE deactivate_for_deniount PROCEDURE IS CALLED TO DEACTIVATE 
ALL OTHER SEGMENTS AND UPDATE THEIR VTOCES 

J THIS IS DONE BY WALKING THE AST HIERARCHY FROM THE BOTTOM 
UP, DEACTIVATING A SEGMENT, ITS SIBLINGS, AND ITS PARENTS, 
ETC. 

I THIS IS DONE TO ENSURE CONSISTENT QUOTA VALUES IN VTOCES 
AFTER SHUTDOWN, BECAUSE QUOTA MUST BE UPDATED FROM THE 
BOTTOM UP 

I ALL VOLUMES ARE DEMOUNTED, THEIR VOUME AND VTOC MAPS UPDATED, 
AND LABELS CHANGED TO INDICATE SUCCESSFUL DEMOUNT 

D THE ORDER IS NOT IMPORTANT, EXCEPT THAT THE RPV GOES LAST 



Not To Be Reoroduced Il-IB tBOA 



FILE SYSTEM SHUTDOWN 



MEMORY IS FLUSHED AGAIN 



IF ANY DRIVES WERE INOPERATIVE, THIS IS ANNOUNCED, AND THE 
RPV IS NOT DEMOUNTED 

THIS MAKES IT POSSIBLE TO FIX THE BROKEN DRIVE AND DO AN 
EMERGENCY SHUTDOWN TO FINISH SHUTDOWN 



IF THERE WERE NO PROBLEMS, THE RPV IS DEMOUNTED AND MEMORY IS 
FLUSHED ONE LAST TIME. ALL RELEVANT INFORMATION IS >NOT ON 
DISK 



AT THE END OF FILE SYSTEM SHUTDOWN, ALL CONSOLE MESSAGES ARE 
ALLOWED TO COMPLETE, AND THE SYSTEM RETURNS TO BOS 
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EMERGENCY SHUTDOWN 



B EMERGENCY SHUTDOWN IS DONE AFTER A CRASH OR SHUTDOWN FAILURE 



LIKE NORMAL SHUTDOWN, THE MISSION OF ESD IS TO SHUT DOWN THE 
FILE SYSTEM, AND IT DOES THIS BY MAKING THE SYSTEM WORK WELL 
ENOUGH TO CALL shutdown_f ile_systeni 



UNLIKE NORMAL SHUTDOWN, IT CANNOT ASSUME THAT NORMAL MECHANISMS 
ARE OPERATIONAL, AND MUST MAKE THEM WORK FIRST 



AFTER THE SUPERVISOR IS MADE OPERATIONAL, EMERGENCY SHUTDOWN 
TRANSFERS TO THE NORMAL FILE SYSTEM SHUTDOWN 



B THE FOLLOWING STEPS ARE TAKEN TO REANIMATE THE SUPERVISOR: 
. EMERGENCY SHUTDOWN STARTS OUT RUNNING IN ABSOLUTE MODE 

IT ENTERS APPENDING MODE, FINDS THE PRDS FOR THE PROCESSOR IT 
IS RUNNING ON, SETS IT UP AS ITS STACK 

B ALL CRITICAL LOCKS (PAGE TABLE, APT) ARE FORCIBLY UNLOCKED. 
TRAFFIC CONTROL IS DISABLED. THE PROCESSOR RUNNING IS NOW 
THE ONLY ONE, AND LOCKS ARE UNNECESSARY 

D . THE CONSOLE AND SYSERR MECHANISMS ARE RESET 

1 SUPERVISOR I/O SUPPORT, IN PARTICULAR THE DISK DIM, IS 
REINITIALIZED 

B THE STATE OF PAGE TABLES AND THE CORE MAP IS MADE CONSISTENT 

D THIS IS DONE BY pc_recover_SSt AND CAN BE DONE ONLY 
BECAUSE ALL OF PAGE CONTROL IS CODED TO FOLLOW PROTOCOLS 
ABOUT THE ORDER IN WHICH TO UPDATE RELATED DATA 
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EMERGENCY SHUTDOWN 



BECAUSE OF THIS, IF PAGE CONTROL IS INTERRUPTED AT ANY 
POINT, IT IS POSSIBLE TO DETERMINE WHAT IT WAS DOING AND 
COMPLETE THE OPERATION 

THIS STEP IS CRUCIAL TO BEING ABLE TO TAKE PAGE FAULTS 
LATER IN SHUTDOWN 



BECAUSE THERE IS NO GUARANTEE THAT THE PROCESS WHICH CRASHED 
THE SYSTEM .(AND THUS, THE ADDRESS SPACE WHERE ESD IS RUNNING) 
IS NOT DEFECTIVE, ESD REBUILDS ITS PDS FROM THE template_pds 

8 ESD SWITCHES TO THE inzr_stkO AND CALLS wired_shutdown 

ALL THE ABOVE STEPS WERE DONE IN ALM. wired_shutdown IS A 
PL/ I PROCEDURE 

D THE VTOC BUFFER IS CHECKED TO SEE WHETHER ANY OPERATIONS WERE 
IN PROGRESS. IF SO, THOSE VOLUMES ARE MARKED (IN THE PVT) TO 
INDICATE THAT THEY MAY HAVE INCONSISTENCIES 



I MEMORY IS FLUSHED 

THE VTOC MANAGER IS REINITIALIZED ■ 

AT THIS POINT,, THE SUPERVISOR SHOULD BE WORKING WELL ENOUGH 
TO RUN shutdown_f ile_systein. FROM NOW ON, EMERGENCY SHUTDOWN 
FOLLOWS THE SAME PATH AS NORMAL SHUTDOWN 



IF EMERGENCY SHUTDOWN FAILS, FOR TAKING A FAULT OR SOME OTHER 
REASON, IT CAN BE RETRIED INDEFINITELY 



SHUTDOWN IS MARKED COMPLETE IN VOLUME LABELS, AND THESE ARE NOT 
UPDATED UNTIL THE VERY END. THUS, NO HARM CAN COME FROM 
RETRYING ARBITRARILY 



ESD TRIES TO CORRECT ALL THE PROBLEMS THAT MIGHT ARISE. 
BECAUSE OF THE COMPLEXITY OF THE SUPERVISOR, IT DOES NOT 
ALWAYS GET ALL OF THEM 
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OVERVIEW OF SALVAGERS 



a FUNCTION 



ENSURE THE CONSISTENCY OF THE FILE SYSTEM DATABASES AND PERFORM 
PERIODIC PREVENTIVE MAINTENANCE OPERATIONS 



THERE ARE SEVERAL SALVAGERS, EACH WITH A DIFFERENT FUNCTION 



BECAUSE OF THE COMPLICATED INTERACTIONS THEY HAVE WITH THE REST 
OF THE FILE SYSTEM, THE SALVAGERS ARE PERHAPS THE MOST 
COMPLICATED SINGLE PROGRAMS IN THE SUPERVISOR 



SOME SALVAGING IS DONE AUTOMATICALLY, WHEN THE SYSTEM DETECTS AN 
INCONSISTENCY. OTHER SALVAGE OPERATIONS ARE EXPLICITLY 
REQUESTED, BY PRIVILEGED USERS. 



EZCEPT FOR SUPERVISOR BUGS, THE ONLY TIME DAMAGE OCCURS THAT 
REQUIRES SALVAGING TO FIX IS AFTER A CRASH WHERE EMERGENCY 
SHUTDOWN FAILS 



a THE SALVAGERS: 



I DIRECTORY SALVAGER 



CORRECTS INCONSISTENCIES IN DIRECTORY SEGMENTS BY REBUILDING 
THEM 



THIS IS THE ONLY SALVAGER INVOKED AUTOMATICALLY IN USER 
PROCESSES: ANY ATTEMPT TO LEAVE RING ZERO WITH A DIRECTORY 
LOCKED FOR WRITING WILL CAUSE IT TO BE SALVAGED 
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OVERVIEW OF SALVAGERS 



DIRECTORY SALVAGING ALSO RECLAIMS WASTED SPACE IN THE 
DIRECTORY, AND IS RUN PERIODICALLY TO COMPACT DIRECTORIES 



QUOTA SALVAGER 

CORRECTS INCONSISTENCIES IN THE QUOTA SYSTEM 

PHYSICAL VOLUME SCAVENGER 



RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION FROM THE 
VTOCES ON A VOLUME, THEREBY RECLAIMING ANY RECORDS OR VTOCES 
WHICH MIGHT HAVE BEEN LOST 



RUNS ENTIRELY ONLINE WHILE THE SYSTEM IS UP FOR USERS {NEW IN 
MRl 0,1) 



THIS TYPE OF DAMAGE IS USUALLY BENIGN, SO RUNNING THE 
SCAVENGER CAN BE DELAYED. 



PHYSICAL VOLUME SALVAGER 

B RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION 

RUNS ONLY DURING INITIALIZATION, AND THEREFORE DELAYS CRASH 
RECOVERY 



NOW USED ONLY FOR RARE CASES WHERE THERE IS NOT ENOUGH FREE 
SPACE LEFT FOR THE SCAVENGER TO RUN. IN THESE RARE CASES, IT 
IS INVOKED AUTOMATICALLY BY SYSTEM INITIALIZATION. 



SWEEP PV 
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OVERVIEW OF SALVAGERS 



I DELETES UNUSED VTOC ENTRIES WHICH HAVE NO DIRECTORY ENTRY 
POINTING TO THEM 



RUNS ENTIRELY IN USER RING, EXCEPT FOR ACTUALLY READING VTOC 
ENTRIES AND DIRECTORY ENTRIES 



D PURELY A HOUSEKEEPING FUNCTION, AND RUN ONLY RARELY. 
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DIRECTORY SALVAGER 



THE DIRECTORY SALVAGER IS USED FOR TWO MAIN PURPOSES: DAMAGE 
CORRECTION AND STORAGE RECLAIMATION 



u 



DIRECTORY DAMAGE oc^o^ C^S '^^^• 



I DAMAGE CAN OCCUR IN A DIRECTORY FOR SEVERAL REASONS: 

DISK I/O ERROR WRITING BAD DATA TO A DIRECTORY SEGMENT 
SUPERVI SOR BUG , > -r i f 

D CRASH WITHOUT ESD , WHERE THE DIRECTORY WAS UPDATED, BUT NOT 
FULLY WRITTEN TO DISK 

O ACTUAL- DAMAGE TO DIRECTORIES IS COMPARATIVELY RARE, BUT: 

B IF A FAULT OCCURS FOR ANY REASON" WHILE A USER HAS A' DIRECTORY 
LOCKED, THE SYSTEM ASSUMES THE DIRECTORY COULD BE AT FAULT, 
AND SALVAGES -Afu.^'=(?<-"-1' 

THIS SORT OF SALVAGING IS DONE BY THE online_salvager 
PROGRAM, WHICH IS INVOKED DYNAMICALLY BY verify_lock IF A 
PROCESS ATTEMPTS TO LEAVE RING ZERO ("CRAWL OUT") WITH A 
DIRECTORY LOCKED v»^"- v^Af^^-^OS- 

1 ORDINARILY, THERE IS NOTHING WRONG, AND THE SALVAGER JUST 
CHECKS OVER THE DIRECTORY 

I IF THE DIRECTORY IS DAMAGED, IT IS "REPAIRED" AS WELL AS 
POSSIBLE 
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DIRECTORY SALVAGER 



ffdC^S^^JlVs. ^^-^ W''"-^ e.eT-NjPc''^ 



UNFORTUNATELY, THE MOST COMMON FORMS OF DAMAGE DESTROY THE 
DIRECTORY HEADER SO THAT NO REPAIR IS POSSIBLE, AND THE 
DIRECTORY MUST BE REINITIALIZED AS EMPTY 



a STORAGE RECLAIMATION 



DIRECTORY SPACE CANNOT ALWAYS BE EFFICIENTLY RE-USED, AND 
UNUSABLE SPACE ACCUMULATES AS ENTRIES ARE CREATED AND DELETED 



IT IS NOT PRACTICAL FOR THE SYSTEM TO COMPACT DIRECTORIES 
WHEN THIS HAPPENS, SINCE THIS COULD CAUSE MAJOR RESOURCE 
CONSUMPTION, AND CAUSE EXPENSE FOR RANDOM PROCESSES 



INSTEAD, THE DIRECTORY SALVAGER IS PERIODICALLY RUN IN 
Salvager.SysDaemon PROCESSES TO REBUILD ALL THE DIRECTORIES 
IN THE HIERARCHY, COLLECTING ALL FREE SPACE 

O THIS IS DONE BY CALLS TO hphcs_$salv_di rectory 

IF THE Salvager PROCESSES DETECT DAMAGE, IT IS CORRECTED AS 
WELL 



DEMAND DIRECTORY SALVAGING IS USUALLY ALSO INSTRUCTED TO LOOK 
FOR AND CORRECT "CONNECTION FAILURES" 

I A CONNECTION FAILURE IS A DIRECTORY BRANCH WHICH INDICATES 
A FREE VTOCE, OR A VTOCE WITH A DIFFERENT UID THAN THE 
BRANCH. THIS MEANS THAT THE DIRECTORY AND VTOC ARE 
INCONSISTENT 

D CONNECTION FAILURES ARE USUALLY DELETED BY DEMAND 
SALVAGING (THIS IS AN OPTION) 

ONLINE SALVAGING DOES NOT DELETE CONNECTION FAILURES 
BECAUSE IT IS NOT ALWAYS POSSIBLE TO IDENTIFY THEM 
PROPERLY DURING AN ONLINE SALVAGE 
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DIRECTORY SALVAGER 



DEMAND DIRECTORY SALVAGING CAN ALSO BE USED BY SYSTEM 
MAINTENANCE PERSONNEL WHEN THERE APPEAR TO BE DIRECTORY PROBLEMS 
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, QUOTA SALVAGING 



QUOTA SALVAGING CORRECTS INCONSISTENCIES IN THE HIERARCHY OF 
QUOTA-USED VALUES 



B THESE INCONSISTENCIES ARISE AFTER A CRASH WHERE ESD FAILS: 

A SEGMENT {>udd>a>b) IS DELETED, FREEING PAGES, AND THE ASTES 
OF ITS PARENT (>udd>a) AND ITS PARENT'S PARENT (>udd) ARE 
UPDATED TO REFLECT "THIS DECREASE IN QUOTA USED 

THE VTOCE FOR >udd>a IS WRITTEN TO DISK DURING NORMAL 
OPERATION. THE VTOCE FOR >udd IS NOT 

B THE SYSTEM CRASHES, AND NO ESD IS PERFORMED 

B WHEN THE SYSTEM COMES BACK UP, THE VTOCE FOR >udd IS 
INACCURATE: IT CLAIMS THAT RECORDS ARE STILL IN USE, WHEN IN 
FACT THEY WERE FREED 

B IF A NEW SEGMENT (>udd>a>c) IS NOW CREATED, IT MAY SPURIOUSLY 
CAUSE A RECORD QUOTA OVERFLOW ON >udd. 



QUOTA SALVAGING IS PERFORMED ENTIRELY ONLINE, WHILE THE SYSTEM 
IS RUNNING, USUALLY IN A Salvager .SysDaemon PROCESS 

I THE FUNDAMENTAL PRINCIPLE BEHIND THE QUOTA SALVAGER IS THAT 
QUOTA INCONSISTENCIES CANNOT ARISE DURING NORMAL OPERATION: 
IF QUOTA IS CONSISTENT, OR INCONSISTENT BY n RECORDS, IT WILL 
STAY THAT WAY UNLESS EXPLICITLY CORRECTED 

B THE QUOTA SALVAGER PROCESS WALKS THE HIERARCHY FROM THE 
BOTTOM UP, USING do_subtree, CORRECTING INCONSISTENCIES IN A 
DIRECTORY AND ALL ITS SIBLINGS, THEN IN THEIR PARENT, AND SO 
ON UP 
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QUOTA SALVAGING 



AN hphcs_ ENTRY IS CALLED TO CORRECT EACH DIRECTORY, ON THE 
ASSUMPTION THAT ALL ITS CHILDREN ARE CONSISTENT 



THE ACTUAL CORRECTION 
MANIPULATION OF VARIOUS 
Storage System PLM (AN61) 



MEGHAN I SM I NVOLVES 
LOCKS . REFER TO 
FOR A DESCRIPTION 



COMPLICATED 
THE Multics 
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PHYSICAL VOLUME SCAVENGER 



B THIS IS ALSO PRIMARILY USEFUL AFTER A CRASH WITHOUT ESD 



IT REBUILDS THE VOLUME MAP AND VTOC MAP FOR A VOLUME BY 
EXAMINING ALL THE VTOCES AND ASTES FOR SEGMENTS ON THE VOLUME 



IT RUNS WHILE THE VOLUME IS IN USE BY USERS, AND NO INTERRUPTION 
OF SERVICE OCCURS 



DAMAGE TO THE MAPS OCCURS AFTER A CRASH WHEN THE STOCKS, IN 
MEMORY, DO NOT GET PROPERLY UPDATED TO THE MAPS ON DISK 

BECAUSE OF THE STOCK MANAGEMENT POLICIES, THIS IS ALWAYS 
BENIGN: RECORDS MAY BE MARKED IN -USE THAT ARE NOT, BUT IT IS 
NOT POSSIBLE FOR THE MAP TO INDICATE A RECORD AS FREE 
(REUSABLE) WHEN IT BELONGS TO A SEGMENT ON THE VOLUME 



FOR RECONSTRUCTING THE VOLUME MAP, THE SCAVENGER WORKS BY AN 
INTERACTION WITH THE PAGE CONTROL RECORD ALLOCATION MECHANISM 

I IT BUILDS A MAP, IN scavenger_data , THAT SAYS WHAT VTOCE OWNS 
EACH RECORD ON THE VOLUME, AND THEN RESOLVES THE 
INCONSISTENCIES BETWEEN THAT AND THE MAP ON DISK 

I THE DATABASE IS WIRED FOR THE DURATION OF THE SCAVENGE, 
AND CAN BE QUITE LARGE {64K FOR AN MSU0 501) 

WHILE A SCAVENGER IS RUNNING, PAGE CONTROL KEEPS THE 
DATABASE UP TO DATE AS IT ALLOCATES AND FREES RECORDS 



B FOR VTOCES, THE PROBLEM IS MUCH SIMPLER: THE VTOC IS SIMPLY 
SCANNED, AND ALL IN-USE VTOCES ARE RECORDED 
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PHYSICAL VOLUME SCAVENGER 



vtoc_man ALSO KEEPS THE TABLE UP TO DATE AS IT FREES AND 
ALLOCATES VTOCES ON THE VOLUME 



A VTOCE THAT APPEARS IN-USE MAY NOT NECESSARILY BE PART OF 
THE HIERARCHY — sweep_pv IS RUN TO TAKE CARE OF THAT 



AFTER THE NEW MAPS ARE CONSTRUCTED, THEY ARE WRITTEN TO DISK 



J THE SCAVENGE RUNS ENTIRELY IN RING ZERO, BUT IT CAN BE SAFELY 
INTERRUPTED AND RESTARTED FROM THE BEGINNING AT ANY TIME 

THE SCAVENGER ACCESSES THE VTOC USING vtoc_man 

THE SCAVENGER TAKES ABOUT FIFTEEN MINUTES PER VOLUME, BUT THE 
SYSTEM IS UP WHILE IT DOES SO 
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PHYSICAL VOLUME SALVAGER 



THIS DOES THE SAME JOB AS THE SCAVENGER, BUT CAN RUN ONLY WHEN THE 
VOLUME IS UNAVAILABLE TO USERS 



I BECAUSE IT HAS THE VOLUME ALL TO ITSELF, IT IS MUCH SIMPLER: 

IT SCANS THE VTOC, BUILDING THE SAME SORT OF DATABASES AS THE 
SCAVENGER 



WHEN FINISHED, IT RESOLVES INCONSISTENCIES, AND WRITES THE 
MAPS BACK TO DISK 

THE VOLUME SALVAGER ACCESSES THE VTOC USING 
salv_abs_seg_NN 



THE VOLUME SALVAGER TAKES ABOUT A MINUTE AND A HALF PER VOLUME, 
BUT ALL VOLUMES MUST BE SALVAGED BEFORE THE SYSTEM CAN RUN AGAIN 



AFTER A CRASH WITHOUT ESD, ALL VOLUMES- MOUNTED AT THE TIME OF 
THE CRASH ARE PRESUMED TO BE INCONSISTENT 



fl THE VOLUME SALVAGER IS LARGELY OBSOLETE TODAY. IT IS RETAINED 
TO DEAL WITH RARE SITUATIONS WHICH MAKE IT IMPOSSIBLE TO BRING 
THE SYSTEM UP FAR ENOUGH TO RUN THE SCAVENGER WITHOUT FIRST 
REBUILDING THE FILE MAP TO FREE UNUSED SPACE 
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SWEEP PV 



B sweep_pv ELIMINATES ORPHAN VTOCES 



AN ORPHAN VTOCE IS ONE WHICH APPEARS TO DESCRIBE A VALID 
SEGMENT, BUT DOES NOT APPEAR IN ANY DIRECTORIES 

I ORPHANS ARE USUAL.LY CREATED BY CRASHES OR DIRECTORY DAMAGE 
WHERE THE DIRECTORY COULD NOT BE REPAIRED 

I ORPHANS ARE ALSO SOMETIMES CALLED "REVERSE CONNECTION 

FAILURES" 



SweeD_pv WORKS BY INSPECTING EVERY VTOCE ON A VOLUME, AND 
ATTEMPTING TO FIND ITS PARENT 

J THERE IS A "UID PATHNAME" IN PART 3 OF ALL VTOCES WHICH 
CONTAINS THE UIDS OF ALL ITS PARENT DIRECTORIES 

[ BY STARTING FROM THE ROOT, AND SEARCHING EACH DIRECTORY IN 
THE PATH FOR THE UID OF THE NEXT ONE, THE VTOCE CAN BE FOUND 

I IF IT CAN'T BE FOUND, IT IS AN ORPHAN, AND SWEEP_PV 
DELETES IT 



IT IS POSSIBLE TO "ADOPT" ORPHANS INTO A DIFFERENT PLACE IN THE 
HIERARCHY IF IT IS IMPORTANT TO RECOVER THEIR CONTENTS, USING 
THE adopt_seg TOOL 



THE UID PATHNAME OF A VTOCE CAN BE INTERPRETED MANUALLY BY USING 
THE vtoc Dathname TOOL 
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INITIALIZER OVERVIEW 

B FUNCTION 

B THE SYSTEM'S INITIALIZATION, ADMINISTRATIVE AND CONTROL PROCESS 
(Initializer. SysDaemon.z), RESPONSIBLE FOR: 

I INITIALIZING THE OPERATING SYSTEM AT BOOTLOAD , FOLLOWING 
SUCCESSFUL INITIALIZATION OF THE SUPERVISOR 

B ANSWERING SERVICE (login and logout) 

I PROCESS CREATION AND DESTRUCTION 

MESSAGE COORDINATOR (DAEMOJ^ COORDINATION) 

SYSTEM ADMINISTRATION FUNCTIONS 

1 SYSTEM ACCOUNTING FUNCTIONS 



B MAJOR DATA BASES, ALL KEPT IN >scl 



I ANSWER_TABLE 



ABSENTEE USER TABLE 



B DAEMON_USER_TABLE 
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INITIALIZER OVERVIEW 



I MASTER GROUP TABLE (MGT) 



D CHANNEL DEFINITION TABLE (CDT) 



SYSTEM ADMINISTRATION TABLE (SAT) 



D PERSON NAME TABLE (PNT) 



I PROJECT DEFINITION TABLES (PDT'S) 
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SERVICES OF INITIALIZER 



THE Initializer.SysDaemon PROCESS PERFORMS VARIOUS SERVICES 
NECESSARY FOR THE SUPERVISOR. MANY OF THEM ARE PERFORMED BY THE 
INITIALIZER PRIMARILY FOR CONVENIENCE, SINCE IT IS EASIER TO 
CONTROL RESOURCES IN A CONTROLLED ENVIRONMENT SUCH AS A SINGLE 
PROCESS THAN TO CREATE A MECHANISM WHICH CAN BE RUN IN ALL 
PROCESSES 



g SYSTEM INITIALIZATION AND SHUTDOWN 

B THE Initializer PROCESS IS CREATED FROM THE ENVIRONMENT THAT 
INITIALIZES THE SUPERVISOR 

D WHEN THE SYSTEM IS SHUT DOWN, THE Initializer COORDINATES THE 
ORDERLY CESSATION OF SYSTEM ACTIVITY AND CALLS 
hphcs $ shut down TO SHUT DOWN THE SUPERVISOR 



I LOGICAL VOLUME MANAGEMENT 

n THE Initializer PROCESS HANDLES ALL REQUESTS FROM USER 
PROCESSES TO MOUNT AND UNMOUNT PRIVATE LOGICAL VOLUMES 

IT ALSO MAKES THE NECESSARY CHECKS TO ACCEPT A VOLUME INTO 
•THE HIERARCHY OR REMOVE IT FOR DEMOUNTING 



J RESOURCE CONTROL 

O THE Initializer DOES ALL THE CONTROL, ASSIGNMENT, AND ACCESS 
CHECKING OF RESOURCES (SUCH AS I/O DEVICES) CONTROLLED BY RC? 



I PROCESS CREATION AND DESTRUCTION 
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SERVICES OF INITIALIZER 



THE Initializer CREATES AND DESTROYS ALL PROCESSES, SCHEDULES 
ABSENTEE PROCESSES, AND HANDLES "CONSOLE" I/O FROM DAEMON 
PROCESSES 



AN IMPORTANT SERVICE OF PROCESS MANAGEMENT IS PROCESS DIR 
VOLUME MANAGEMENT, IN WHICH THE Initializer PICKS THE LOGICAL 
VOLUMES USED FOR PROCESS DIRECTORIES 



THE Initializer ALSO HANDLES ALL PROCESS ACCOUNTING AND LOAD 
CONTROL 



D COMMUNICATIONS 



THE Initializer MANAGES LOADING / DUMPING OF FNPs AND 
SOFTWARE COMMUNICATIONS MULTIPLEXERS 



IT ALSO HANDLES ALLOCATION OF COMMUNICATION CHANNELS, BOTH 
FOR PROCESSES LOGGING IN AND REQUESTS MADE THROUGH 
dial_manager_ 



B DYNAMIC RECONFIGURATION 

I THE Initializer RUNS THE DYNAMIC RECONFIGURATION SOFTWARE, 
AND UPDATES THE SYSTEM LOAD LIMITS WHEN THE CONFIGURATION 
CHANGES 



ACTUALLY, ANY PROCESS WITH hphcs_ ACCESS CAN USE THE 
RECONFIGURATION COMMANDS, BUT ONLY THE Initializer CAN KEEP 
ALL THE ACCOUNTING DATABASES UP TO DATE 
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METER AND TUNING OVERVIEW 



WHILE NOT A SUBSYSTEM ITSELF, METERING AND TUNING IS A POLICY AND 
CAPABILITY COMMON TO ALL OF THE SUPERVISOR'S SUBSYSTEMS 



s FUNCTION 



B METERING (CONSISTS OF THREE ACTIVITIES) 

ACCUMULATING DATA: THIS IS PERFORMED THROUGHOUT THE 
SUPERVISOR BY CODE WHICH 

RECORDS THE NUMBER OF TIMES AN EVENT HAPPENS OR A 
PARTICULAR PIECE OF CODE IS EXECUTED; AND /OR 

O RECORDS THE TIME REQUIRED TO PERFORM A TASK 

SUCH DATA IS STORED IN AREAS REFERRED TO AS "METERING 
CELLS" 



EXTRACTING DATA: THIS IS PERFORMED BY NUMEROUS METERING 
COMMANDS WHICH (WHEN INVOKED) 

READ AND STORE THE CURRENT VALUES OF RELEVANT METERING 
CELLS 



REPORTING THE DATA:" THIS IS PERFORMED BY THE METER COMMANDS 
WHICH (WHEN INVOKED) 

fl COMPARE CURRENT METERING CELL VALUES WITH PREVIOUSLY READ 
VALUES 

I PERFORM THE APPROPRIATE ARITHMETIC COMPUTATIONS UPON THE 
DATA IN ORDER TO ARRIVE AT THE DESIRED STATISTIC 

I ARRANGE THE DATA IN A USEFUL FORMAT (A REPORT OR DIAGRAM) 

AND PRINT IT 
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METER AND TUNING OVERVIEW 



I TUNING 

CHANGING THE SYSTEM'S OPERATING PARAMETERS AND /OR 

CONFIGURATION BASED UPON THE DATA AND INSIGHTS FROM THE 
SYSTEM'S METERS 



B MAJOR DATA BASES 



I SST HEADER, TC_DATA HEADER, ETC, 
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ANALYZING PERFORMANCE PROBLEMS 



B MDLTICS IS VERY HEAVILY INSTRUMENTED WITH MANY METERING COMMANDS 



I MOST SOLVABLE PERFORMANCE PROBLEMS SHOW DP QUITE DIRECTLY IN THE 
METERS 



IF THE SYSTEM IS TOO SLOW, THERE ARE GOOD RULES OF THUMB TO 
FOLLOW TO LOOK FOR WHEN PROBLEM 



NO TWO SYSTEMS ARE IDENTICAL - THE MOST IMPORTANT INFORMATION 
YOU HAVE IS HOW THE METERS ARE DIFFERENT FROM THE WAY THEY WERE 
WHEN THE SYSTEM WAS WORKING BETTER 



NOT ALL TUNING PROBLEMS CAN BE RESOLVED WITH SOFTWARE, OFTEN IT 
SIMPLY INDICATES THAT THERE IS NOT ENOUGH MEMORY, OR NOT ENOUGH 
DISK CAPACITY. IT IS OFTEN 'DIFFICULT TO DETERMINE WHAT HARDWARE 
CHANGES WOULD BE MOST COST-EFFECTIVE 



total time meters - THE FIRST STEP 



total_time_meters MAY INDICATE EXCESSIVE TIME SPENT IN SEVERAL 
AREAS: 



PAGE FAULTS - TOO MANY PAGE FAULTS MEAN NOT ENOUGH MEMORY, 
TOO MANY ELIGIBLE PROCESSES (max_eligible) , WHICH CAUSE 
THRASHING, INSUFFICIENT DISK CAPACITY, OR INEFFICIENT 
APPLICATIONS 

I LOOK TO f ile_system_meters, device_meters, AND disk_meters 
FOR MORE HELP 
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ANALYZING PERFORMANCE PROBLEMS 



SEGMENT FAULTS - TOO MANY ALMOST ALWAYS MEAN THAT THE AST 
POOLS (sst CONFIG CARD) ARE TOO SMALL 

LOOK TO file_system_ineters (AST Pool grace time) FOR MORE 
HELP 



INTERRUPT - USUALLY MEANS EXCESSIVE INTERRUPT ACTIVITY EITHER 
FOR FNPS OR BECAUSE OF EXCESSIVE PAGING, BUT MAY INDICATE 
HARDWARE PROBLEMS 

O LOOK TO interrupt_ineters TO ' LOCALIZE IT, THEN TO 
f ile_systein_ineters and system_coniin_meters 

OTHER FAULT - GENERALLY INDICATES TOO MANY CONNECT OR TIMER 
RUNOUTS FAULTS, INDICATING EXCESSIVE TRAFFIC CONTROL ACTIVITY 

D LOOK TO THE TUNING PARAMETERS (ptp) AND 
traffic control meters FOR MORE HELP 



MP IDLE - INDICATES TOO MUCH TRAFFIC CONTROL ACTIVITY, 
USUALLY BECAUSE THERE ARE TOO MANY ELIGIBLE PROCESSES 
(max_eligible) AND/OR NOT ENOUGH MEMORY 

D LOOK TO THE TUNING PARAMETERS (ptp), f ile_system_meters , 
device_meters, disk_meters, AND traf f ic_control_meters FOR 

MOPP. HP.T.P 



WORK CLASS IDLE - THIS IS CPU TIME WASTED BECAUSE GOVERNED 
WORKCLASSES WERE NOT PERMITTED TO USE IT, AND NO OTHER TAKERS 
WANTED IT 

I FREQUENTLY NOT A PROBLEM, BUT MAY INDICATE A NEED TO 
READJUST WORKCLASSES ( work_class_meters ) 

NMP IDLE, ZERO IDLE - INDICATE THAT CPU TIME HAS GONE TO 
WASTE BECAUSE NO PROCESSES WANTED IT. NMP IDLE MEANS THAT 
THERE ARE MORE PROCESSORS THAN PROCESSES THAT WANT CPU TIME, 
AND ZERO IDLE MEANS THERE ARE NO PROCESSES AT ALL 
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ANALYZING PERFORMANCE PROBLEMS 



NORMALLY INSIGNIFICANT QUANTITIES - THE FOLLOWING NUMBERS 
SHOULD ALWAYS BE VERY SMALL; LARGE VALUES PROBABLY INDICATE A 
HARDWARE OR SOFTWARE PROBLEM 

PC LOOP LOCKS 
BOUND FAULTS 
TC LOOP LOCKS 
POST PURGING 
LOADING IDLE 
OTHER OVERHEAD 
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DETAILED PROBLEM ANALYSIS 



THE MORE DETAILED METERING COMMANDS CAN BE USED TO PIN DOWN A 
PROBLEM 



DETAILED DESCRIPTIONS CAN BE FOUND IN THE Multics Metering 
Manual (AN52) 



THE DETAILED METERS SHOULD ALSO BE CHECKED IF THERE IS NO 
OBVIOUS PROBLEM SHOWN BY total time meters 



AGAIN, THE REALLY IMPORTANT THING IS TO BE ABLE TO COMPARE 
AGAINST PREVIOUS DATA FOR YOUR SITE 



iS SOME GOOD PLACES TO LOOK ARE; 



interrupt_meters 



D UNUSUALLY LONG DISK INTERRUPTS MAY INDICATE LOCKING PROBLEMS 
- SEE disk meters 



TOO MUCH TOTAL TIME SPENT WITH DISK INTERRUPTS USUALLY MEANS 
TOO MANY PAGE FAULTS, WHICH WILL BE SHOWN IN MORE DETAIL BY 
f ile_systein_meters 

FNP INTERRUPTS ARE TYPICALLY MUCH LONGER THAN OTHERS. TOO 
MUCH FNP INTERRUPT TIME MAY INDICATE A BAD FRONT END CHANNEL, 
BUT THIS IS RARE 
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DETAILED PROBLEM ANALYSIS 



g f ile_system_meters 

1 A SHORT PAGE LAP TIME MEANS THAT PAGES ARE NOT STAYING IN 
MEMORY LONG ENOUGH,' THAT IS, THERE IS NOT ENOUGH MEMORY 

I FREQUENT PAGE CLAIM RUNS INDICATE THAT THE WRITE LIMIT IS TOO 
LOW 



IF THE AVERAGE PAGE FAULT DURATION IS HIGH, IT CAN MEAN THAT 
THE WRITE LIMIT IS TOO HIGH, AND THAT DISK ALLOCATION LOCKS 
ARE A LIMITATION? SEE disk meters TO CHECK 



SHORT AST POOL GRACE TIMES MEANS THAT THE POOL SIZES SHOULD 
BE INCREASED. THIS IS USUALLY ALSO INDICATED BY TOO HIGH A 
FREQUENCY OF SEGMENT FAULTS 



g disk_meters 

8 WHEN THE ATB I/O FOR A DRIVE IS'TOO LOW, THE DRIVE IS A 
SERIOUS BOTTLENECK. 

THIS OFTEN HAPPENS FOR RLV DRIVES, BECAUSE OF DIRECTORIES 

IF PARM DIRW IS ON, IT SHOULD BE TURNED OFF 

B TOO HIGH A PERCENTAGE OF ALLOCATION LOCKS INDICATE THAT TOO 
MANY WRITES ARE BEING QUEUED SIMULTANEOUSLY, AND MAKING IT 
IMPOSSIBLE TO GET A QUEUE ENTRY FOR READING 

THIS USUALLY MEANS THAT WRITE LIMIT IS TOO HIGH 



device meters 



IF THE SUBSYSTEM BUSY PERCENTAGE IS TOO CLOSE TO THE DISK 
CHANNEL CAPACITY, IT USUALLY MEANS THAT THERE ARE TOO FEW 
PHYSICAL DISK CHANNELS 
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OUTPUT FROM METERING COMMAND S 
total time meters 



TOTAL_TIME_METERS - OVERVIEW OF HOW THE SYSTEM 
RESOURCES, ALSO MEASURED AGAINST NON-IDLE TIME 



IS USING ITS 



Total metering time 



Page Faults 

PC Loop Locks ■ 
PC Queue 
Seg Faults 
Bound Faults 
Interrupts 
Other Fault 

Getwork 

TC Loop Locks 

Post Purging 
MP Idle 

Work Class Idle 
Loading Idle 
NMP Idle 
Zero Idle 
Other Overhead 
Virtual CPU Time 62.53 




AVE 

l?f37209 

348.946 

9579.170 

17426.208 

1713.504 

660.550 

247.788 
1407.132 






,^, P^^ 



f^v/^ 



f 






M 



e.<\y6^- 




0>^'^'''C/^-"9"^ 



Sp 



ffiM^ 



'y^~\^a 



lA/'T/v/p-^^ >0 7^ 



(68.5^ 

2) fwA (Ui>~ >^^£- If" >/?00 T*-^^ 
-7-, ^oTlW KcKT, H'^sK cU<:«: oI;5!c->--<''pO 

C<^otlC -f'Jp ^s.y^^^ MY9f5^ 'S'Oi^^QjN/ V'. 
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OUTPUT FROM METERING COMMANDS 
interrupt meters 



fi INTERRUPT^METERS -■ COUNTS & TIMING FOR ALL I/O INTERRUPTS 



Tot 


al metering time 0: 


20:28 




lOM Ch 


Int 


Avg Time 


% CPU 


Name- 


A 


6. 


11 


2.043 


0.00 


lOM A 


A 


10. 


379 


1.553 


0.01 


prtb 


A 


13. 


9253 


3.436 


0.65 


fnp c 


A 


14. 


19 


0,788 


0.00 


ope 


A 


16. 


26248 


1.347 


0.72 


tapa 


A 


17. 


128 


1.328 


0.00 


tapa 


A 


18. 


13097 


5.383 


1.43 


fno b 


A 


20. 


21041 


0,860 


0.37 


dska 


A 


21. 


2881 


0.860 


0.05 


aska 


A 


22. 


8486 


0.877 


0.15 


dskb 


A 


23. 


257 


0.964 


0.01 


dskb 


A 


24. 


17896 


0.895 


0.33 


dsk.b 


A 


25. 


2573 


0.943 


0.05 


dskb 


A 


26. 


10486 


0.857 


0.18 


dqka 


A 


27. 


255 


0.899 


0.00 


dska 


A 


2S. 


2-:717 


0.845 


C..43 


dskc 


A 


29. 


2319 


0.849 


0.04 


dskc 


A 


30. 


9915 


0.845 


0.17 


dskc 




31. 


215 


0.767 


0.00 


dskc 


B 


14. 


236 


0.877 


0.00 


fnD d 


B 


15. 


6917 


3.351 


0.47 


fnp f 


B 


IS. 


3547 


3.543 


0.26 


fnp a 


B 


19. 


13667 


3.435 


0.96 


fnp e 


B 


20. 


22013 


0.881 


0.39 


dskb 


B 


21. 


474 5 


0,863 


0.08 


dskb 


B 


22. 


6054 


0.861 


0.11 


dska 


B 


23. 


60 


0.925 


0.00 


dska 


B 


24. 


15946 


0.867 


0.28 


dska 


B 


25. 


989 


0.841 


0.02 


dska 


B 


26. 


12757 


0.863 


0.22 


dskb 


B 


27. 


1020 


0.903 


0.02 


dskb 


B 


28. 


5178 


0.838 


0.09 


dskc 


B 


29. 


30 


0.653 


0.00 


dskc 


B 


30. 


16582 


0.823 


0.28 


dskc 


B 


31. 


825 


0.841 


0.01 


dskc 


B 


32, 


1764 


0.825 


0.03 


dske 


Chan 


262506 


1.464 


7.82 




Ovh 


d 


258932 


0.230 


1.21 




Total 


258932 


1.713 


9.03 





special 
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OL;'pUT from WtTERING COMMANDS 
f i 1 e system meters 



E - ^lE_SYSTEM METERS - DISPLAYS MISCELLANEOUS METERING IMFORMATlON 
FOR THE F ILE SYSTEM 



ONLY PARTS RELEVANT TO SEGMENT 
8 (PAGE CONTROL) FOR THE REST 



CONTROL INCLUDED HERE; SEE TOP 



"otal mete''ing time 



0:20:02 



£ 



ATE 



Act i vat Ions 

segf 5Lji t 

makeknown 

c 1 t-sctor i es 
Deact ' vat i ons 
DefT.and deactivate 

ottemots 
Sec Faults 
'fault 

cal 1 

act i vat i ons 
Bound Faults 
Setf aul ts 

access 
ASTE Trickle 
Steps 
3k i PS 

ens 

meiM 

i ni t 
Searcnes 
C leanups 
Force wr i tes 

pages wr i tten 
Lock AST 



10;3 

Ik 

9f 

103d 

3 
5080 

i,3!l 

963 
"20 

u2 

139 

i*279 

JO 16 

'- i ' 
1083 

li,f,2 



3 

3 
18i*22 



1.153 sec. 

1.2iti sec. 52.505% of al 1 
IS. 251 sec. 7.095% of all 
12.527 sec. 5-204% of ai 1 

1.139 sec. 



1*00.857 sec. 

0.237 sec. 

0.2''S sec. 

1.5c.ij sec. 

1.2L! sec. 

5.ufefe sec. 

266.191 msec. 

26.635 sec. 

8.652 sec. 
281 .01*0 msec. 

0.355 sec. 

t.i,3S sec. 

1 . 1 10 sec . 

O.72J4 sec. 

0.000 sec. 
1056 1.139 

1+00.857 sec. 
1*00.857 sec. 

0.065 sec. 



8L.862% of Sec Faults 
15. 138% of Sec Faults 
19.075% of Seg Faults 



u.5J/Ti ui 



70.1481.% of Steos 

5-585% of Skips 

35.509% of Skips 

55.106% of SKLips 



sec, 



0.1 % of real time 
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OUTPUT FROM METERING COMMANDS 
file system meters 





AVE/] 


.ock 






% 






AST locked 


4.833 


msec 


• e 


7 


.4 






AST lock waiting 


1.601 


msec 


' 


2 


.5 






AST Sizes 


4 




16 






64 


256 


Number 


1701 




601 






221 


74 


Need 


819 




202 






208 


34 


Steps 


2341 




645 






1139 


154 


Ave Steps 


2.9 




3.2 






5,5 


4.5 



Lap Time(sec) 873.8 1120.5 233.3 577.9 
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OUTPUT FROM METERING COMMANDS 
file svstem meters 



FILE_SYSTEM_METERS - DISPLAYS MISCELLANEOUS METERING INFORMATION 
FOR THE FILE SYSTEM 



ONLY PARTS RELEVANT TO PAGE CONTROL INCLUDED HERE; SEE TOPIC 7 
(SEGMENT CONTROL) FOR THE REST 



Total metering time 0:20:02 

# ATB 

Needc 62654 19.194 msec. 

Ring faults . 16.639 % 

PDIR faults 50.607 % 

Level 2 faults 21.556 % 

DIR faults" 7.645 % 

New Pages 14.661 % 

Volmap_seg 0.000 msec. 

Zero pages 770 1561.779 msec. 

Laps 105 11.453 sec. 

Steps - 361483 3.327 msec. 

Skip 322555 ' 3.728 msec. 89.231% of Steps 

wired 11057 108.761 msec. 3.428% of Skip 

used 109719 10.960 msec. 34.016% of Skip 

fc pin 37717 31.884 msec. 11.693% of Skip 

cl pin 23726 50.686 msec. 7.356% of Skip 

3419 pages, 139 wired. 
Average steps 5.770 
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OUTPUT FROM METERING COMMANDS 
device meters 



S DEVICE_METERS - DISPLAYS SUMMARY OF I/O ACTIVITY FOR ALL DISK 
SUBSYSTEMS 



Total metering time 


0:20:13 










dska 


dskb 


dskc 


dskd 


Prior Page I/O 


ft 

18571 


17743 


462 


1273 


ATB 


65.334 


68.383 


2626.240 


953.121. 


Other Page I/O 


6525 


5135 


16 


696 


ATB 


185.949 


236.284 


75832.692 


1743.280 


ATB Page I/O , 


48.347 


53.034 


2538.332 


616.212 


Prior VTOCE I/O 


934 


895 


38 


304 


ATB 


1299.061 


1355.668 


31929.554 


3991.194 


ATB I/O 


46.612 


51.037 


2351.401 


533.798 


% Busy 


76 


74 





4 


Avg. Page Wait 


47.289 


46.197 


20.341 


24.666 


Avg. Page '^Wait 


176.082 


101.023 


36.996 


61.704 


Avg VTOCE Wait 


41.138 


37.610 


38.595 


29.090 


Avq . Paae I /O T 


35.619 


38.314 


20.050 


22.482 


Avg. VTOCE I/O T 


31.139 


32.277 


37.060 


26.606 


EDAC Corr. Errs 














Errors 











1 


Fatal Errors 
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OUTPUT FROM METERING COMMANDS 
disk meters 



B DISK METERS - DISPLAYS I/O ACTIVITY TO DISK DRIVES 



ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 



od Co(?y 



sVN^ ol>f>, w^rV 



Total 


metering time 


0:20:12 




^ vx 




^.^ 




Subsy 


stem 


dska 


Count 


Waits 


f %Waits Avg. 


Wait (ms. ) 




call 


locks 


26005 


217 





.83 


0. 


259 




run 1 


ocks 




112 








,00 


0. 


000 




interrupt 


locks 


25998 


239/ 





.92 


0. 


208 




allocations 
Drive Reads 


26001 
Writes 


l3> 

Seek 




ATB 


0. 


000 

ATB 


ATB 










Distance Reads 


Writes 


I/O 


1 




269 


67 


214 




4508 




18102 


3609 ^li^^^'^^"^"-^'^ 


3 




362 


243 


109 




3350 




4991 


2004 


4 




309 


131 


184 




3925 




9258 


2756 


5 




547 . 


165 


180 




2217 




7350 


1703 


6 




631 


165 


161 




1922 




7350 


1523 


7 


























8 




5843 


2187 


122 




207 




554 


151 


9 




566 


116 


153 




3313 




10455 


2516 


11 




3501 


1431 


200 




346 




847 


245 


12 























125 - VffYi-'^^y 


16 




7158 


2508 


135 




169 




463 
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OOTPUT FROM METERING COMMANDS 
disk queue 



% Of 




8 DISK_QUEUE - DISPLAYS I/O QUEUE FOR A DISK SUBSYSTEM ' 
I ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 

tor le^S 

Connects = 2604781, 1359725, 677321, 309367, '^^^'•■^^k. 
123430, 40159, 10227, 1969. 





p 


RW 


VP 


DV 


SECTOR 


MEM 





W 


P 


24 


1350330 


27304000 





W 


p 


9 


1020150 


4432000 





W , 


p 


16 


1204130 


36246000 





w 


p 


16 


314370 


27306000 





w 


p 


16 


314430 


34166000 


^ 


-w;i 


K ■ 


>j)T^\ 1 ( Vv, 


^ w^To»-J 










<!/ 







/ 1 



\ 
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OUTPUT FROM METERING COMMANDS 
print configuration deck 



PRINT CONFIGURATION_DECK - DISPLAYS >sll>conf ig_deck , WHICH 
CONTAINS INFORMATION ABOUT DISK LOCATIONS, THE RLV, AND PARTITIONS 



I ONLY THE PART OF THE CONFIG DECK RELEVANT TO VOLUME MANAGEMENT 
AND DISK CONFIGURATION IS SHOWN HERE 



root dska 16. dskb 25. dskb 23. 'dskb 24. dska 

part bos dska 16. 

part dump dska 16. 

part log dska 16. 



prph 


dska 


a 


20. 


2 


451. 


16. 








chnl 


dska 


a 


26. 


2 


b 


24 


. 2 


b 


22. 


2 


prph 


dskb 


b 


20. 


2 





16 


. 451 


• * 


16. 




chnl 


dskb 


b 


26. 


2 


a 


24 


. 2 


a 


22. 


2 


prph 


dskc 


a 


28.. 


2 


501. 


32. 








chnl 


dskc 


a 


30. 


2 


b 


30 


. 2 


b 


28. 


2 


prph 


dske 


b 


32. 


2 


451. 


8. 








chnl 


dske 


b 


34. 


2 














prph 


dskf 


a 


32. 


2 


501. 


16. 








chnl 


dskf 


a 


34. 


2 














mpc 


mspa 


451 


a 


20 




4 


a 24, 




4 




mpc 


mspb 


451 


. b 


20 




4 


b 24, 




4 




mpc 


mspc 


607 


a 


28 




4 










mpc 


mspd 


607 


. b 


2B 




4 










mpc 


mspe 


451 


. b 


32 




4 










mpc 


mspf 


607 


a 


32 




4 
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OUTPUT FROM METERING COMMANDS 



print configuration deck 



8 DISK CONFIGURATION CONFIG CARDS 



i ROOT 



I IDENTIFIES THOSE VOLUMES IN THE ROOT LOGICAL VOLUME WHICH 
HAVE HC PARTITIONS, USED BY THE SUPERVISOR FOR PAGING OF 
SUPERVISOR SEGMETNS 



8 PART 

i IDENTIFIES THE LOCATIONS OF CERTAIN IMPORTANT PARTITIONS 



ONLY PARTITIONS NECESSARY FOR KULTICS OPERATIONS ARE 
IDENTIFIED, NOT ALT PARTITIONS 



HC PARTITIONS ARE LOCATED BY THE ROOT CARD 

I PRPH DSKn, CHNL 

IDENTIFY PHYSICAL I/O CHANNEL PATHS FOR ACCESSING DISK DRI\^S 

B MPC 

fl IDENTIFY PHYSICAL CONNECTIONS TO MICROPROGRAMMED DISK 
CONTROLLERS 
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OUTPUT TROW METERING COftnAKDS 
list VO 1 s 



E l!S~ vols - DISPLAYS ft TABLE Or ONLINE VCLUnES, THEIR LOCATION, AND 
SPACE UTILIZATION 



Dr i ve 


Recoras 


Left 


% VTOCEs Left 


% A 


vg 


PV 


PB/PD 


LV Name 












s 


i2e 


^ame 






GSUc_i7 


bkSOL 


54730 


85 


13440 11356 


84 


4 


'alphaOl 


pb -fit 


Alpha 


dskc_i8 


6i^50i* 


55389 


86 


13i*40 11352 


84 


4 


alpha02 


Db pd 


A i pha 


dska_C5 


36U5 


5305 


35 


8400 2662 


32 


5 


mul03 


pb pd 


^\ul ti cs_Pubs 


csks~06 


36^.26 


4323 


12 


8400 2365 


28 


5 


mulOl 


pb pd 


hul t iCS_rUDS 


dSKb'ig 


36i*28 


4632 


13 


8400 2813 


35 


7 


mu102 


Db pd 


f.ul tics~Pubs 


dskb_26 


36429 


13690 


38 


8400 4326 


52 


5 


mul05 


pb pd 


rtul t ics_Pubs 


dskb_27 


36U9 


4672 


13 


6400 2333 


28 


5 


mulOi* 


pb pd 


nul tiCS_FuDE 


dsk2_01 


3630S 


4680 


13 


9000 450 


5 


3 


cubO 1 


pb pt^ 


Publ ic 


CSk5_03 


36268 


35S8 


10 


9200 1017 


11 


3 


pub07 


D3 PC 


Pubi ic 


dSk£_Ou 


3626E 


4500 


12 


5200 884 


10 


3 


pub04 


pb pd 


Pub i i c 


csks'os 


36263 


4816 


13 


5200 864 


9 


3 


pubQ2 


pb pd 


PuDi ic 


csKb_i7 


36269 


4281 


12 


9200 1002 


11 


1 


pjDD5 


Db pd 


Pjbl ;c 


dskb_:S 


3626S 


384C 


11 


5200 535 


6 


3 


PL'bOc 


pb pd 


Pud! 1 c 


c=kc_!5 


bkSOk 


294 





13-440 5535 


LI 


e 


relCl 




Release 


d s k c_ 1 ii 


6^50L 


265 





13440 5214 


39 


7 


relC2 




Release 


askc_Oi 


6^503 


43631 


68 


131.40 IC032 


•jz 


r 

c 


xpubOl 


pb 


Xpub 1 i c 


dskc C2 


i>k50l 


45502 


71 


13440 9B3E 


75 


5 


XDubu2 


pb . 


Xpub ; 1 c 


cskcl03 


61^503 


42374 


66 


13440 9639 


73 


6 


XpiJDO* 


Db 


XdjdI ic 


dskc_0i. 


6i*503 


43591 


68 


13440 9785 


73 


^ 


xpub04 


pb 


XpuDl ic 


askc_C9 


6i.50; 


58010 


90 


13440 12394 


92 


6 


xpub05 


pb 


Xpub 1 ic 


dskc~lD 


6^*50!, 


36736 


88 


i3i.40 12^07 


52 


7 


xpub06 


pb 


ApLiD i i C 


cskc_2 1 


6i.5C3 


23S47 


37 


13i*itC 6446 


48 


5 


ypubOl 


pb 


Ypubi ic 


cskc_22 


64503 


23744 


37 


13L40 6I94 


46 


5 


ypubG2 


Db 


Ypubl ic 


dskc 29 


64=05 


23794 


37 


13440 6185 


46 


5 


yDUb05 


Db 


YpuDl i c 


cs.;cl3C' 


645-3 


24111 


37 


13440 646 1 


48 


5 


y2ubOc 


pb 


YDubl ic 


dskc_C" 


6*^503 


11723 


18 


13^40 6149 


46 


7 


zpubOi 


pb pd 


ZDLlb \ i c 


cskc_05 


645C3 


11665 


IS 


13440 6429 


48 


' 


2PUDC2 


DD pd 


ZDut ; ic 


dskc_23 


64504 


5777 


15 


13440 6O94 


45 


7 


2pub03 


pb pd 


Zpubi ic 


dskc 2k 


64504 


II805 


18 


13440 6141 


46 


7 


2pub04 


pb pd 


Zpubl ic 


askc_25 


64504 


11514 


18 


13440 7407 


55 


B 


2pub05 


pb pd 


Zpubl i c 


dskc_26 


64504 


12958 


20 


13440 7149 


53 


8 


2pub06 


pb pd 


Zpubl i c 


dEke_06 


37089 


8053 


22 


5100 3797 


74 


22 


1 istOl 


pb pt 


1 ist_! 


d5ka_12 


37562 


6046 


16 


2735 957 


35 


17 


1 ist02 


pb 


i i s t_2 


dska_07 


37309 


6825 


18 


4000 2107 


53 


16 


1 ist03 


pb 


1 i st_3 


dska~08 


36209 


3827 


11 


7000 491 


7 


4 


roots 


pb 


root 


dska~!l 


36209 


85S7 


24 


7000 4181 


60 


9 


root.6 


pb 


root 


dska_l& 


31263 


2852 


5 


9000 3476 


39 


5 


rpv 


pb 


root 


dskb_23 


36208 


4888 


13 


7000 455 


7 


4 


root3 


pb 


root 


dskb~2L 


36209 


3097 


9 


7000 238 


3 


4 


root4 


DD 


root 


dskb~2= 


36350 


4483 


12 


7000 223 


3 


4 


root2 


PD 


root 
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OUTPUT FROM METERING COHMANDS 
traffic control queue 



B TRAFFiC_CONTROL_QUEUE - DISPLAYS THE 
SCHEDULER QUEUES, USEFUL FOR GETTING 
PROCESSES ARE DOING 



CURRENT CONTENTS OF THE 
AN IDEA OF WHAT THE USER 



I FIRST PART OF OUTPUT IS ELIGIBLE QUEUE; 



avq = 13, 


, elapsed time = 12it7 sec, 61« 


active 


last ! 


i5 sec. 






flags 


dtu 


dpf 


temax 


te 


ts 


ti 


tssc 


event d 


ws wc process 


rWLE (d) 


148 


6946 


2097 


37 








-0.001 





6 


Initial izer 


xLED(c) 


!5 


nil 


1000 


910 


2012 


1897 


0.001 





11 


6 Slbert 


rLE(d) 


U 


1370 


500 


89 








-0.009 








4 Diaz 


rLE(d) 


15 


823 


500 


13 








-0.009 





64 


8 JCrow 


wLE (d) 


13 


634 


500 


422 








0.018 


316537 


3 


5 Gintel 1 


xWLED (a) 


6 


108 


1000 


495 


2054 


2004 


0.010 





13 


6 Brunei le 


wL£(d) 


16 


864 


1000 


85 





510 


0.016 


504031 


46 


6 W'Pecic 


wWLE (b) 


4*68 


2734 


1000 


315 


3010 


8000 


0.013 


22i.641 


4 


3 Scratt 


wLE (d) 


17 


6S6 


500 


60 








0.007 


165111 


^ 
^ 


i. RTowle 


wLE (b) 


12 


52c 


500 


50 








0.005 


71 


3 


3 Kress 


wLE (d) 


6S 


1895 


500 


21 








0.001 


177022 





2 OPCTL 


xLED (b) 


12 


872 


500 


85 








0.005 








3 Psndoif 


rL£(d) 


S7 


3279 


500 











-0.006 








3 Lackey 
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OUTPUT FROM METERING COMMANDS 
traffic control queue 



SECOND PART IS REALTIME, INTERACTIVE, AND ALL WORKCLASS QUEUES 



REALTIME QUEUE: 

INTERACTIVE QUEUE: 

WORKCLASS 2 QUEUE: credits = 576 ms. 

WORKCLASS 3 QUEUE: credits = 242 ms. 

f 289 5326 1000 503 0.218 22 3 Dupuis 

r " 131 2513 1000 4010 8000 0.128 3 Falksenj 

WORKCLASS 4 QUEUE: credits = 2601 ms. 

WORKCLASS 5 QUEUE: credits = 4000 ms. 

WORKCLASS' 6 QUEUE: credits = -563 ms. 

WORKCLASS 7 QUEUE: credits = 3962 ms . 

rW 5 166 . 500 COO C.192 00 27 Saccuci 

WORKCLASS 6 QUEUE: credits = 3934 ms. 

WORKCLASS 9 QUEUE: credits = 2216 ms. 

WORKCLASS 11 QUEUE: credits = 4000 ms . 
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OUTPUT FROM METERING COMMANDS 
traffic control meters 



» THAFFIC_CONTROL_METERS - DISPLAY THE STATE OF THE SCHEDULER 



J OUTPUT COMES IN THREE PARTS, SHOWN OUT OF ORDER HERE: 

QUEUE LENGTHS AND RESPONSE TIME - THESE ARE V?EIGHTED AVERAGES 
OVER THE LAST FIFTEEN SECONDS. 

ACTIVITIES VERSUS DEPTH - HOW DEEP THE TRAFFIC CONTROLLER HAD 
TO SEARCH TO FIND A SCHEDULABLE PROCESS 

1 MISCELLANEOUS COUNTERS AND FREQUENCIES OF VARIOUS EVENTS 



Total metering time 0:20:34 

Ave queue length 16.52 

Ave eligible 13.31 

Response time 0.264 sec 

DEPTH %PF TBPF %GTW TBS %CPU 

1 12.0 22.8 10.8 11.6 8.1 

2 11.8 21.0 9.2 12.2 7.4 

3 10.8 24,9 8.7 14.1 8.0 

4 10.2 27.9 8.5 15.2 8.4 

5 9.5 29,8 8.3 15.5 8.4 

6 8.4 33.5 7.8 16.5 8.4 

7 7.4 36.3 7.3 16.8 8.0 

8 30.0 48.6 39.5 16.8 .43.3 
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OUTPUT FROM METERING COMMANDS 
traffic control meters 



COUNTER 


TOTAL 


ATI 


1 


#/INT 


Interactions 


7977 


0.155 


sec 




Loadings 


12161 


0.102 


sec 


1.525 


Blocks 


14082 


0.088 


sec 




Wakeups 


36078 


0.034 


sec 




Schedulings 


12591-.. 


0.098 


sec 


1.578 


Lost priority 


1 


1234.756 


sec 




Priority boosts 





o-.ooo 


sec 




I/O boosts 


578 


2.136 


sec 




Wait Page 


127040 


9.719 


msec 


15.926 


Wait PTL 


75691 


16.313 


msec 


9.489 


Wait Other 


31912 


38.693 


msec 


4.001 


Total Waits 


234643 


5.262 


msec 


29.415 


Notify Page 


128954 


9.575 


msec 




Notify PTL 


75691 


16.313 


msec 




Notify Other 


25330 


48.747 


msec 




Total Notifies 


229975 


5.369 


msec 




Get Processor 


245856 


5;022 


msec 




Pre-empts 


94235 


13.103 


msec 


11.813 


Getwork 


338802 


3.644 


msec 




Retry getwork 


4986 


0.248 


sec 




Extra notifies 


2949 


0.419 


sec 




Last EN event 


000000000071 






Last NTO event 


03302223 


7767 







ALARM_CLOCK_METERS - DISPLAYS INFORMATION ABOUT THE USER ALARM 
TIMER FACILITY (HARDCORE INTERFACE FOR timer_manager_) 



Total metering time 



0:20:31 



No. alarm clock sims, 
Simulation lag 
Max. lag 



2171 

5.245 msecs. 
1.7340314e4 msecs, 
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OUTPUT FROM METERING COMMANDS 
print tuning parameters 



PRINT_TUNING_PARAMETERS - PRINT VALUES 
PARAMETERS. MOST CONTROL THE SCHEDULER 



FOR SYSTEM CONTROL 



Current system tuning parameters: 



tef irst 

telast 

timax 

priority sched_inc 

min_eligTble 

max_eligible 

max_batch_elig 

working_set_f actor 

working_set_addend 

deadline_mode 

int_q_enabled 

post_purge 

pre_empt_sample_t ime 

gp_at_notify 

gp_at_ptlnotify 



UJ. W(.C9S 



^.-,1 ^ 



quit_priority 
gv_integration 
realtime_io_priori: v 
realtime_io_deadline 
realtime_io_quanturi 
notify_tTmeout_interval 
not i f y^t imeout_sever i ty 
write Timit 



0.5 seconds 

1. seconds 

6. seconds 

80. seconds 

2. 

20. 



0.5 



off 

on 

on 

0.04 seconds 

off 

off 

^« ^ € W V/ 1 1 Wl hJ 

0. 

4, seconds 

on 

0. seconds 

0.005 seconds 

30. seconds 



724 



THESE ARE "INTERNAL", NORMALLY NEVER CHANGED, 
IF THE -all CONTROL ARGUMENT IS GIVEN 



AND ONLY PRINTED 



stack_truncation on 

stack_truncation_always off 
stk__trunc_block_avg_f actor 0.25 
trap_invalid_masked off 
meter_ast_lockinc off 

checksum filemao on 
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OUTPUT FROW METERING CQWnANDS 
work class meters 



e WORK CLASS nETERS - DISPLAY THE VARIOUS WORKCLASS PARAttETERS . AND 
SHDW~WHAT RESOURCES EACH WORKCLASS IS CONSUniNG. 



Total metering time 0:20:38 



^C %GUAP 


%MAX 


%TCF 


V/ELIG 


PW 


IRESP 


1 QUANT 


RESP 


QUANT 


P 


M 


R 


LCG ■ 







3- 


0.12 


3 


C.26 


•2.10 


0.26 


2.10 


P 





R 


Imi t 


! 




3 


O.OS 




0.25 


0..75 


0.50 


1.00 


B 





R 


RT i me 


2 7- 




15 


O.kk 












P 







System SysAdt? OPR Ft 


3 32. 




hh 


0.49 












P 







SysProg SysOev 


k 9. 


u. 


k 


0.26 












P 







SEngr 


5 20 




2 


O.itD 












P 







1 HEngr 


e 12 


16. 


8 


0.25 












P 







nktUS MktFor hKtEd 


7 3 


7. 


i* 


. 0.36 












P 









8 6 







O.IB 












P 







1 OffAjto 


S ^ 


8. 


^ 

£. 


. 0.62 












F 







f:isc Kfg 


10 3 







. 0.55 












P 







1 Other 


:i k 




2 


0.16 












P 







1 Ssecisl 



TCFU percents (IGUAR) control non-rea!time work_c 1 asses . 
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OUTPUT FROM METERING COMMANDS 
respons meters 



RESPONS£_METERS - DISPLAYS RESPONSE TIME. BASED ON TERMINAL 
INTERACTIONS, ON A PER-WORKCLASS BASIS 



Total metering time 0:20:36 



WC ---Thir 


Iks/— 


----Response 


Times 


by VCPU Range---- 


- — Queues--- 


-VCPU 


Range- 


# 


Avg 


Avg 


Resp 


# 


Avg 


From 


To 


Int 


VCPU 


RT 


fart 


86 


2.70 


0.00 


0.50 


113 


0.04 


0.42 


9.34 


32 


0.15 


0.50 


1.00 


3 


0.55 


5.51 


10.00 






1.00 


10.00 


3 
119 


2.43 
0.12 


14.96 
0.91 


6.15 
7.76 










1 35 


11.78 


0.00 


0.50 


34 


0.11 


0.96 


8.74 


39 


0.21 


0.50 


1.00 


2 

36 


0.83 
0.15 


4.06 
1.13 


4.87 
7.55 










: 553 


U.90 


0.00 


G.50 


620 


0.05 


0.43 


10.50 


612 


0.15 


0.50 


1.00 


28 


0.71 


3.61 


5.10 






1.00 


10.00 


39 


1.77 


8.39 


4.74 










687 


0.17 


1.07 


C -V •* 








,iLZ 


3 2i+96 


6.38 


0.00 


0.50 


2993 


0.08 


0.66 


7.96 


2622 


0.17 


0.50 


1.00 


117 


0.68 


4.22 


6.16 






i.OO 


10.00 


66 


2.46 


13.47 


5.49 






10.00 


99.99 


10 
3186 


56.85 
0.33 


99.59 
1.65 


3.33 

4.96 










k 581 


15-82 


0.00 


0.50 


663 


G.05 


0.71 


12.54 


590 


0.26 


0.50 


1.00 


13 


0.64 


4.64 


7-30 






1.00 


10.00 


8 
684 


3.47 
0.11 


32.07 

1.15 


9.24 
10.88 










5 133 


29.51 


0.00 


0.50 


148 


0.06 


0.83 


12.95 


Ul 


0.17 


0.50 


1.00 


3 


0.69 


4.64 


6.70 






1.00 


10.00 


5 


3.15 


10.24 


3.25 






10.00 


99.99 


2 

158 


26.69 
0.51 


48-84 
1.81 


1.83 

3.55 



Load Control Group 



Init 



RTime 



System SysAdsr OFR FED 



SysProg SysDev 



Stngr 



HEngr 
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OUTPUT FROM METERING COMMANDS 
respons meters 

USD 11.65 0.00 0.5C 977 0.05 1.13 20.91 MktUS MktFor MktEc 

1211 0.5E 0.50 1.00 24 0.64 4.95 7.74 

1,00 10.00 16 1.8S 11. 8S 6.29 

_.... _.„„ 1017 0.10 1.39 14.38 

259 14.65 0.00 0.50 292 0.08 1.53 20.17 DS-CC 

287 0.98 0.50 1.00 9 0.71 9.03 1-2.66 

1.00 10.00 17 2.04 14.76. 7.24 

10.00 99.99 1 12.22 99.99 9.45 

„____ 319 0.24 2.81 11.86 

73 2.69 0.00 0.50 79 0.06 0.31 5.45 OffAuto 

74 0.05 0.50 1.00 2 0.60 6.40 10.62 

1.00 10.00 1 3.20 6.73 2.10 
82 0.11 0.54 4.94 

S4 41.91 0.00 0.50 80 0.11 1.23 11.07 Kisc Mfg 
96 0.30 0.50 1.00 11 0.69 4.74 6.91 
1.00 10.00 13 2.99 12.82 4.30 
104 0.53 3.C5 . 5,74 

7 99.99 0.00 0.50 10 0.11 1.45 13.82 Other 
6 0.21 1.00 10.00 i 3.88 39.11 10.05 
■ 11 0.45 4.88 10.89 

4'7 12.71 0.00 0.50 445 0.03 0.50 15.32 Specicl 
420 0.16 0.50 1.00 5 0.57 3.61 6.29 
1.00 10.00 4 1.65 1-1.40 6.90 
454 0.05 0.63 11.93 

5954 11.15 0.00 0.50 6454 0.07 0.77 11.40 

6192 C.29 0.50 1.00 21'7 0.68 4.54 6.70 

l.OC 10.00 173 2.31 13.11 5.68 

10.00 99.99 15 48.77 99.99 3.32 



6857 0.24 1.51 6.39 



66757 calls to iiieter_response_tiine 283 invalid transitions, 

Overhead = 0.09% ( 0.052 ms./call) 
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OUTPUT FROM METERING COMMANDS 
system performance graph j ' ^ 



SYSTEM_PERFORMANCE_GRAPH - GIVES 
ACTIVITY, SAMPLED PERIODICALLY 






^pol (oK 



e. 



I 






ROUGH |SNAPSHOT 



> 



04/02^3 



1114.3 est Sat 
up= 04/01/83 0355.6 est, sys_hours= 26.3,l|cpd_hours= 78.9 

-•- - - - wsa= 0, wsf= 0.50, 



^ 
.' 



OF SYSTEM 



VcfJ uUto5^^^^ 



cpu* 3, pages* 3419, min_e« 3, max_e= 16, 

tefirst= pil3, telast= 0.50, timax= 32.(1 

******* I A*^****** I A^AAA^UJU '^pg y 

********* I **+****** I **iiits 
***iittpp| + . y| 
*******iittps+. y I 

********* I *** + * j^ j^ ^ y 
*********] ***+**£^ |y 
****** j^j^tpp +y I 

1122 . 00 Qe* ******* i ********* I ****+iitp| y 
1123.00 Qe******** I ********* I **mi+ts y 



1115.00 ^^^:^L^.j^ 

1116.00 Qe .**** 
1117.00 Q*e******* 
1118.00 Q*e******* 
1119.00 Qe******** 

1120.00 Qe******** 

1121.01 Q*e******* 



1124.00 Q*e 



******* I ********* I * 



1 1 r+ps I y 



1125.00 Q*e*******]**********miii+tps jy 
1126.00 Q*e*******!****iiiit jtps+. y | 
1127.00 Q*e******* I ********* 1 *i i+tp yl 

xj.iio.uu lyz-c"'^'^"^'^ -• j '^^•- --^^ j '^•- - + '' X J. J. (.ty 

1129.'00 Qe *******]********* I ***+***** I ****i ittp 
1130.00 Qe ******* I ********* I *********** I **i i ittp 
1131.00 Oe ******* 1 ********* I ***•!***** I ****i i itt 
1132 . 00 Qe** ****** I ********* j ***!***** I ****ii i^ 
1133.00 rQ******** 1 ********* I **-fn***** I *ii itts y 
1134.00 Qe******** I ********* I **T****** I ***iitp y 
1135.00 Qe . I ******* I **+****** I ******** i it 

1136.00 Qe******** I ********* I ***V****** i i i tts vl 
1137 . 00 rQ* ******* I ********* I ***-»***** I ****i itts I y 

1138.01 Qe******** I ********* I ***-il***** i i i itp y 

1139.00, 

-Q****""**'** j'**'******* I A**^***** i i i ttpp 



1140.0 




y 
y 









- - .fi oafS "^ V«^<- 



■^ 






VJ5t 



— 1 t>o^(^ 



^■-^ 






^W-^ 



-vnoc£ i:fo 



yC 



\ 
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OUTPUT FROM METERING COMMANDS 
system performance graph 



SOME CHARACTERS INDICATES PERCENTAGES OF SYSTEM TIME SPENT IN 
VARIOUS ACTIVITIES. OTHERS INDICATE ACTUAL VALUES 

D PERCENTAGES 

O BLANK - USER PROCESSING. RING ZERO TIME BETWEEN "y" AND 
THE RIGHT MARGIN, USER RING BETWEEN "s" and "y" 

i SYSTEM SERVICES - SEGMENT FAULTS ("s"), PAGE FAULTS ("p"), 
TRAFFIC CONTROL ("t"), INTERRUPTS ( " i " ) 

IDLE TIME - MP IDLE ("m"), NMP IDLE {"*"), ZERO IDLE 
(BLANKS ON THE LEFT) 

B OTHER VALUES (RELATIVE TO THE LEFT MARGIN) 

TRAFFIC CONTROL QUEUE LENGTHS - READY QUEUE ("q"), 
ELIGIBLE QUEUE ("e") 

D USER COUNTS - NUMBER OF USERS ("+"), LOAD UNITS ("-") 

B TRAFFIC CONTROL VALUES - RESPONSE TIME ("r"), QUITS PER 
MINUTE ("Q"), SCHEDULINGS IN TEN SECONDS. ("S") 






I/O TRAFFIC - DISK I/O PER 100 MILLISECONDS ("D"), VTOC 
I/O PER 100 MILLISECONDS ("V") 
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OUTPUT FROn nSTERING COHMANDS 
meter gate 

METER GATE - SHOWS TIME SPENT CALLING THROUGH SUPERVISOR GATES 
{HCS 7 ETC.) 



Metering since 04/01/83 0855.6 est Fri. 
Total non-idle time at 01+/02/83 1101.9 est 



Sat « 39 ■^^r. 36 min. 57 sec. 



Gate meters for hcs_: 
7 hr. 35 min. Sh sec. 



or 19. 180% spent 



total cal ls'= 629^*028. 
in calls through gate. 



calls 


pent 


avg 


pwai t 


entry name 




902768 


4.50 


7.11 


0.02 


tty_wr i te 




13857 


2.29 


236.01 


2.28 


1 ist_dir 




1*42912 


1.19 


3.85 


0.01 


tty_read 




435510 


1.01 


3.30 


0.02 


tty_order 




165154 


0.97 


8.35 


0.10 


ini t i ate 




120204 


0.83 


9. 84 


0.76 


make_ptr 




20620 


0.51 


34.95 


0.48 


make_seg 




60796 


0.50 


11.69 


. 0.14 


truncate_seg 




45464 


0.45 


14.25 


0.16 


status_long 




337615 


0.40 


1.69 


0.01 


set_alarm_timer 




532081 


0.35 


0.95 


0.00 


read_events 




4085 


0.35 


122.90 


3.57 


star_dir_l ist_ 




42080 


0.33 


11.17 


0.02 


I ist_acl 




59354 


0.32 


7.76 


0.01 


st3tus_for_backLp 




103029 


0.32 


4.44 


0.03 


tty_get_) i ne 




61851 


0.52 


7.33 


0.03 


tty_wr i te_whole_str : 


i ng 


48621 


0.31 


9.05 


0.35 


status_minf 




31637 


0.26 


11.64 


0.04 


set_max_l encth_seg 




150703 


0.26 


2.41 


0.03 


termi nate_ncr.ame 




67267 


0.20 


4.19 


0.03 


tty_read-_echoed 




14851 


0.20 


18.77 


0.08 


quota_get 




21051 


0.18 


12.48 


.0.72 


get_l i nk_target 




30337 


0.18 


8.25 


0.40 


ini tiate_count 




6288 


0.17 


39-36 


0.25 


delentry_seg 




247420 


0.16 


0.95 


0.03 


wakeup 




14024 


0.16 


15.99 


0.43 


status_ 




476759 


0.16 


0.47 


0.00 


level_set 




13601 


0.13 


13.69 


0.00 


dir_quota_read 




14860 


0.13 


12.05 


0.02 


! !St_dir_acl 




13496 


0.13 


13.22 


0.01 


get_max_length 




28194 


0.12 


6.15 


0.41 


make_entry 




23725 


0.11 


6-65 


0.09 


set_bc_seg 




1416 


0.11 


108.00 


2.08 


star_ 




13941 


0. 10 


10.68 


0.40 


get_access_class 




28696 


0. 10 


5.03 


0.04 


status_mins 




13553 




9.76 


0.C2 


1 i st_i nacl_a! 1 
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OUTPUT FROM METER I NG COMMANDS 



meter qate 



12881 


0.08 


8.50 


46180 


0.08 


2.33 


206 , 


, 0.07 


493.77 


11090D5 


0.07 


0.09 



0.39 get_user_ef fmode 

0,01 tty_read_with_mark 

3.79 star__list_ 

0.00 level_get 



.._...,_■r^_r^ J J 1>!_1r> PPHJ 
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OUTPUT FROW nSTERING COmANDS 
meter gate 



HPKCS__ AND iOi_ ARE 
SIGNIFICANT RESOURCES 



mS OTHER SUPERVISOR GATES THAT CONSUME 



Metering since 04/01/83 0855.6 est Fri. 

Total non-idle time at 04/02/83 1102.7 est Sat 



39 hr. 37 min. 59 sec, 



Gate meters for hphcs_: 
hr. 29 min. 51 sec. or 



total cal Is = 70604. 
1.256% spent in calls through gate. 



calls 


pent 


avg 


pwai t 


entry name 


869 


0.57 


928.77 


5.40 


destroy_process_f i n i sh 


911 


0.24 


381.04 


15.09 


create_proc 


5944 


0.20 


48.34 


1.04 


dir_quota_read 


8326 


0.05 


8.47 


0.04 


tty_wr i te_force 


5946 


0.05 


11.31 


0,00 


quota_read 


105 


0.04 


500.68 


0.00 


flush_core 


246 


0.04 


208.83 


■ 0.17 


f lush_ast_pooI 


1753 


0.02 


16.94 


C.76 


star_ 


5595 


0.02 


4.12 


0.00 


set_backup_dump_time 


31895 


0.01 


0.60 


0.00 


set_kst_attr i butes 


I 


0.01 


14598.71 


8.00 • 


ada_scu 



Metering since 04/01/83 0855.6 est- Fri. 

Total non-idle time at 04/02/83 1103.0 est Sat = 39 hr. 38 min. 22 sec. 



Gate meters for ioi_! 
hr . 12 mi n. Ik sec, 



or 



total cal Is = 245985- 
0.515% spent in calls through gate. 



cal Is 


pent 


avg 


pwai t 


entry name 


43976 


0.50 


2.94 


0.00 


connect 


248 


0.01 


65.91 


2.09 


workspace 


793 


0.00 


0.58 


0,00 


get_special_status 


533 


0.00 


0.54 


0.00 


set_event 


322 


0.00 


0.59 


0,14 


set_status 


105 


0.00 


0.55 


0.00 


timeout 


3 


0,00 


4.38 


0.00 


set_channel_requi red 


5 


■ 0.00 


0.65 


0,00 


get_detai led_status 
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Evolution of Memory Addressing/Management 
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15-i F80A 



CONVENTIONAL MEMORY 
STRUCTURE 



» 1 -DIMENSIONAL ADDRESS SPACE USED BY THE SYSTEM 



Not To Be Reproduced 15-1 F80A 



CONVENTIONAL MEMORY 



CHARACTERISTICS 



SPACE DIVIDED INTO REGIONS OF VARIOUS SIZES, ONE REGION PER 
PROCESS/JOB/USER 



g REGIONS ARE: 



I PROTECTED FROM ONE ANOTHER BY A BAR OR BY PROTECT KEYS 



SUBDIVIDED INTO POOLS OF STORAGE USED FORt PROGRAMS, I/O 
BUFFERS, MEMORY ALLOCATION AREA, AUTOMATIC VARIABLES, STATIC 
VARIABLES 



1-DIMENSIONAL ADDRESS SPACE WIRED DIRECTLY ONTO REAL MEMORY 



B PROGRAMS MUST BE LOADED INTO REAL MEMORY 



D MEMORY ALLOCATION FOR REGION 



PROGRAMS AND BUFFERS ALLOCATED WITHIN REGION 



PREPARATORY ADDRESS MODIFICATION (ADDRESSES MUST BE MODIFIED TO 
REFLECT LOCATION WITHIN THE REGION) 



Not To Be Reproduced 15-2 ?80A 



CONVENTIONAL MEMORY 



CHARACTERISTICS 



B LINKAGE EDITING REQUIRED 



ALL SYMBOLIC REFERENCES MUST BE RESOLVED - IMPLYING THAT ALL 
REFERENCED PROGRAMS MUST BE LOADED REGARDLESS OF WHETHER OR NOT 
THEY ARE ACTUALLY NEEDED AT RUN TIME 



8 EXAMPLES: GCOS , IBM OS/MFT, IBM OS/MVT 



Not To Be Reproduced 15-3 F80A 



CONVENTIONAL MEMORY 
PROBLEMS 

s SYSTEM ADDRESS SPACE LIMITED TO SIZE OF REAL MEMORY 



USER ADDRESS SPACES (REGIONS) ARE SMALL. THIS MEANS: 
B PROGRAMS MUST BE WRITTEN TO FIT INTO SMALL REGIONS 



1 SMALL REGION PROGRAMS OFTEN OPERATE LESS EFFICIENTLY IN THEIR 
USE OF CPU TIME THAN A SIMILAR PROGRAM DESIGNED FOR A LARGE 
REGION 



BECAUSE SMALL REGION OPERATION IS PROGRAMMED IN, SUCH PROGRAMS 
CANNOT TAKE ADVANTAGE OF MORE MEMORY WHEN IT CAN BE MADE 
AVAILABLE 



PROGRAMMER MUST WASTE INGENUITY (AND SYSTEM RESOURCES) TO MAKE 
PROGRAMS RUN IN A SMALL REGION: 

[ WRITING OVERLAY PROGRAMS 

11 DIVIDING REGION INTO OPTIONAL-SIZE POOLS 

PROGRAMMING MECHANISMS TO EXTEND OR SWAP-OUT POOLS WHEN THEY 
OVERFLOW 



PROGRAMMER TIME WASTED WHEN PROGRAMS MUST BE CONVERTED TO TAKE 
ADVANTAGE OF LARGER REGIONS WHEN CONFIGURATION IS INCREASED 



Not To Be Reproduced 15-4 F80A 



CONVENTIONAL MEMORY 



PROBLEMS 



B REAL MEMORY IS USED INEFFICIENTLY 



WITHIN A REGION, PROGRAM COMPONENTS OR DATA AREAS NOT REFERENCED 
STILL OCCUPY REAL MEMORY 



UNUSED SPACE BETWEEN REGIONS WASTES REAL MEMORY (FRAGMENTATION) 



8 SCHEMES FOR USING REAL MEMORY MORE EFFICIENTLY ARE COSTLY 



CPU COST OF MOVING REGIONS TO REDUCE FRAGMENTATION 



CPU AND I/O COSTS TO SWAP OUT ENTIRE REGIONS TO SHARE REAL 
MEMORY AMONG MORE USERS 



B NO PROTECTION OF DATA WITHIN A REGION 



PROGRAMMING ERRORS CAN CAUSE UNWANTED WRITING INTO PROGRAM OR 
DATA AREAS 
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CONVENTIONAL MEMORY 



PROBLEMS 



B OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 



B NO SHARING OF PROGRAMS AND DATA BETWEEN REGIONS 



EACH REGION MUST CONTAIN A COPY OF SHARED DATA (INEFFICIENT USE 
OF MEMORY) 



MODIFICATIONS TO SHARED DATA CANNOT EASILY BE REFLECTED IN ALL 
COPIES 



PHYSICAL INPUT/OUTPUT OPERATIONS ON DISK FILES OFTEN BECOME THE 
RESPONSIBILITY OF THE PROGRAMMER (REDUCING PRODUCTIVITY) 
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SINGLE VIRTUAL MEMORY 
STRUCTURE 

B A LARGE ADDRESS SPACE USED BY THE SYSTEM (EG, 4M WORDS) 



8 THE ADDRESS SPACE IS LOGICALLY DIVIDED INTO REGIONS OF VARIOUS 
SIZES, AS IN CONVENTIONAL MEMORY 



B THE VIRTUAL MEMORY IS PHYSICALLY DIVIDED INTO PAGES HAVING A FIXED 
SIZE 



B THE ADDRESS SPACE AND THE VIRTUAL MEMORY HAVE THE SAME SIZE 



THE 1-DIMENSIONAL ADDRESS SPACE IS MAPPED DIRECTLY ONTO THE PAGED, 
1 -DIMENSIONAL VIRTUAL MEMORY 



THE VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO A SMALLER 
(EG, 256K WORDS) REAL MEMORY 



PROGRAMS MUST BE LOADED INTO THE VIRTUAL MEMORY AS IN CONVENTIONAL 
MEMORY SYSTEMS 
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SINGLE VIRTUAL MEMORY 
CHARACTERISTICS 



B LINKAGE EDITING REQUIRED AS IN CONVENTIONAL MEMORY SYSTEMS 



s EXAMPLES : 



IBM OS/VS-1 OR OS/VS-2 RELEASE 1 



Not To Be Recrocuced 15-8 F80A 



SINGLE VIRTUAL MEMORY 



SOLVED PROBLEMS 



s THE SYSTEM'S ADDRESS SPACE IS MUCH LARGER THAN REAL MEMORY 



I THE SYSTEM CAN RUN MORE AND/OR LARGER USER REGIONS 



8 THE USER REGIONS CAN BE LARGER 



8 PROGRAMS CAN BE WRITTEN FOR A LARGE REGION TO TAKE ADVANTAGE OF 
ADDITIONAL MEMORY WHEN IT IS AVAILABLE 



B PROGRAMMER PRODUCTIVITY IMPROVES 



g PROGRAMMERS WORRY LESS ABOUT OPTIMIZING MEMORY USAGE 



CONVERTING PROGRAMS TO USE LARGER MEMORY CONFIGURATIONS OFTEN 
UNNECESSARY - LESS COMPETITION 



B REAL MEMORY USED MORE EFFICIENTLY 



I FEWER UNREFERENCED AREAS OF ADDRESS SPACE OCCUPY REAL MEMORY 



D PAGING ALGORITHM SIMPLIFIES MEMORY MANAGEMENT SCHEMES 
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SINGLE VIRTUAL MEMORY 
PROBLEMS 



MEMORY SWAPPING MAY STILL BE NECESSARY TO SHARE THE ADDRESS SPAC! 
AMONG MANY USERS 



USER REGIONS STILL TOO SMALL TO HANDLE EVERY APPLICATION. SOME 
MEMORY MANAGEMENT STILL REQUIRED 



B NO PROTECTION OF DATA WITHIN A REGION 



K OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 



B NO SHARING OF DATA BETWEEN REGIONS 



EXPLICIT DISK I/O STILL REQUIRED TO ACCESS FILES 



s THE ADVANTAGES OF SOLVING THE PROBLEMS ABOVE MAY BE OUTWEIGHED BY 
COSTS IN HARDWARE AND SOFTWARE OF THE PAGING OVERHEAD 



Not To Be Reioroduced 15-10 F80A 



MULTIPLE VIRTUAL MEMORIES 



STRUCTURE 



B THE SYSTEM USES MANY LARGE (4M WORD), 1-DIMENSIONAL ADDRESS SPACES, 
ONE PER USER REGION 



EACH ADDRESS SPACE CONTAINS THE SUPERVISOR PROGRAMS PLUS ONE LARGE 
USER REGION (DIVIDED INTO'POOLS), PLUS PROGRAMS AND DATA SHARED 
AMONG ALL REGIONS 



EACH ADDRESS SPACE IS MAPPED DIRECTLY ONTO ITS OWN, PAGED VIRTUAL 
MEMORY 



EACH VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO THE 
SINGLE, SMALLER REAL MEMORY 



PROGRAMS MUST BE LOADED INTO THE VIRTUAL MEMORY AS IN CONVENTIONAL 
MEMORY SYSTEMS 



B LINKAGE EDITING REQUIRED AS IN CONVENTIONAL MEMORY SYSTEMS 



Not To Be Reproduced 15-11 F80A 



MULTIPLE VIRTUAL MEMORIES 
CHARACTERISTICS 



B EXAMPLES t 



IBM OS/VS-2 RELEASE 2 (MVS) 



Not To Be Reoroduced 15-12 F80A 



MULTIPLE VIRTUAL MEMORIES 



SOLVED PROBLEMS 



THE LARGE USER REGIONS CAN HANDLE ALL BUT THE LARGEST PROGRAMS 
WITHOUT SPECIAL MEMORY MANAGEMENT, PROGRAMMER MUST STILL DIVIDE 
REGIONS INTO POOLS, HOWEVER, AND SOMETIMES PROVIDE POOL OVERFLOW 
MECHANISMS 



B MEMORY SWAPPING IS NOW UNNECESSARY. PREVIOUSLY SWAPPED REGIONS NOW 
OCCUPY THEIR OWN ADDRESS SPACES AND ARE PAGED IN AND OUT 



B PROGRAMS AND DATA (USUALLY READ-ONLY) CAN BE SHARED BETWEEN REGIONS 
IN A LIMITED WAY BY OCCUPYING THE SAME POOL IN EVERY ADDRESS SPACE 



B NEWLY SOLVED PROBLEMS MAKE PAGING OVERHEAD MORE WORTHWHILE 
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MULTIPLE VIRTUAL MEMORIES 
PROBLEMS 



NO PROTECTION OF DATA WITHIN THE MAJORITY OF A USER'S ADDRESS SPACE 
(REGION) 



B OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 



GENERAL SHARING OF READ-WRITE DATA STILL NOT POSSIBLE 



EXPLICIT DISK I/O STILL REQUIRED TO ACCESS FILES 
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MULTICS VIRTUAL MEMORY 



STRUCTURE 



8 THE SYSTEM USES MANY, VERY LARGE (EG, 256M WORDS), 2-DIMENSIONAL 
ADDRESS SPACES, ONE PER USER PROCESS (REGION) 



B EACH ADDRESS SPACE IS DIVIDED INTO SEGMENTS WHICH PERFORM THE SAME 
FUNCTION AS POOLS IN MULTIPLE VIRTUAL MEMORY SYSTEMS 



8 SEGMENTS ; 



HAVE VARYING SIZES 



AR£ EXTENDABLE 



I ARE FILES IN THE MULTICS STORAGE SYSTEM 



fl ARE ACCESSED AS READ-WRITE, READ-ONLY, EXECUTABLE OR CALLABLE 
DATA, WITH ACCESS CONTROLLED BY AN ACL, RING BRACKETS AND AN AIM 
CLASSIFICATION 



D ARE SHARED AMONG ADDRESS SPACES, WITH EACH ADDRESS SPACE HAVING 
ITS OWN PERMISSION TO ACCESS THE SEGMENT 
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MULTICS VIRTUAL MEMORY 
CHARACTERI STI CS 



EACH ADDRESS SPACE INTERSECTS IN VARYING DEGREES WITH EVERY OTHER 
ADDRESS SPACE 



EACH ADDRESS SPACE IS MAPPED DIRECTLY ONTO ITS OWN PAGED, SEGMENTED 
VIRTUAL MEMORY OF THE SAME SIZE 



EACH VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO THE 
SINGLE, SMALLER REAL MEMORY 



NO LOADING IS REQUIRED SINCE ALL ADDRESSES ARE INTERPRETED AS 
OFFSETS WITHIN SEGMENTS 



NO LINKAGE EDITING IS REQUIRED SINCE ALL SYMBOLIC REFERENCES ARE 
RESOLVED AT RUN TIME IF AND WHEN THEY ARE ENCOUNTERED (DYNAMIC 
LINKING) 
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MULTICS VIRTUAL MEMORY 



SOLVED PROBLEMS 



S DATA WITHIN THE ADDRESS SPACE PROTECTED 



O READ OR READ-EXECUTE DATA STORED IN SEPARATE SEGMENTS WHICH ARE 
PROTECTED FROM MODIFICATION 



B PROGRAMMING ERRORS REFERENCING OUTSIDE ARRAY BOUNDS CANNOT 
REFERENCE DATA IN ANOTHER SEGMENT 



B DATA CAN BE SHARED IN A GENERAL WAY BETWEEN ADDRESS SPACES 



EACH SEGMENT (NOT A COPY OF THE SEGMENT) CAN APPEAR IN SEVERAL 
ADDRESS SPACES 



DIFFERENT PROCESSES CAN HAVE DIFFERENT ACCESS TO THE SAME 
SEGMENT IN THEIR ADDRESS SPACE 



OVERHEAD AND INCONVENIENCE OF LOADING (SOFTWARE) REPLACED BY AN 
ADDRESS FORMATION SCHEME (KAPJDWARE) 



UNREFERENCED PROGRAMS (AND/OR PAGES OF PROGRAMS) DO NOT REQUIRE 
MAIN MEMORY SPACE 
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MULTICS VI RTUAL MEMORY 
SOLVED PROBLEMS 



PROGRAMS NEVER REQUIRE PREPARATORY ADDRESS MODIFICATION 



s EXPLICIT I/O IS NOT REQUIRED TO ACCESS FILES (SEGMENTS) 



i SEGMENTS CAN BE ACCESSED BY MAKING THEM KNOWN TO THE ADDRESS 
, SPACE AND REFERENCING THE SEGMENT 



THIS IS CALLED VIRTUAL FILE I/O 



OVERHEAD AND INCONVENIENCE OF LINKAGE EDITING REPLACED BY DYNAMIC 
LINKING 



UNREFERENCED PROGRAMS DO NOT REQUIRE LINKING 



ADVANTAGES OF VERY LARGE ADDRESS SPACE, SHARED FILES, DATA 
PROTECTION, AND VIRTUAL I/O DEFINITELY OUTWEIGH THE COSTS OF PAGING 
AND SEGMENTATION OVERHEAD 
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MULTICS VIRTUAL MEMORY 
PROBLEMS 



MULTICS FILE I/O IS OFTEN LESS EFFICIENT THEN SPECIAL CASED METHODS 
BASED ON KNOWN ACCESS PATTERNS 



S THE SYSTEM'S SEGMENT SIZE DOES NOT GENERALIZE UPWARD TO HANDLE VERY 
LAR6E data BASES. ALTERNATE (KLUDGY) METHODS MUST BE USED (SUCH AS 
MSF ' S ) 



THE OVERHEAD TO TOUCH A PAGE OF ONE HUNDRED DIFFERENT SEGMENTS IS 

CONSIDERABLY MORE THAN THE OVERHEAD TO TOUCH ONE HUNDRED PAGES OF 

THE SAME SEGMENT. (IE: SPARSE AND INFREQUENT ACCESSING IS 

EXPENSIVE) 



LACK OF EXPLICIT I/O CONTROL MAKES OVERALL SYSTEM RELIABILITY 
SUFFER SINCE FULL RECOVERY FROM A SYSTEM CRASH REQUIRES THE 
SUCCESSFUL FLUSHING OF ALL PAGES FROM MAIN MEMORY 



hcs_$f orce_write 
SUCH RELIABILITY 



MAY BE USED BY THOSE APPLICATIONS REQUIRING 



Not To Be Reoroduced 



15-19 
(End Of Topic) 



F80A 



Massachusetts Institute of Techno lo 
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Printout of the 59 Entries 
of the 
Libraries 
Include.**, hard.sowrce 

Which Match the Search Names 
add_type.1ncl.pl1. a1m_temp1ate.1ncl.pn. apte. Incl .pli . aste. Incl .pi 1 . bos_dun,p. Inci .pi 1 . crap. Inci .pll . dbm. Inci .pi 1 . 

dlr_ac1.incl.p11. dlr.allocat 1on_area. Incl .pit . dlr_entry . Incl .pi 1 . dlr_header . Incl .pi 1 . d1r_ht . Inci .pi 1 , 

d1r_Hnk.1ncT.pn. d1r_narae. Incl .pi 1 . dirlockt . Incl .pi 1 . dl8k_pack. Incl .pi 1 , dskdcl . Incl .pi 1 . ect_structures. Incl .pi 1 . 

event_walt_1lst. Incl. pll, faul t_vector . Incl .pit . fgbx. Incl .pi 1 . f 8_dev_type3. Incl .pi 1 . f a_types. Incl .pi 1 , 

fs_vol_1aba1. Incl. pit, hc_lock. Incl .pi 1 . I tt_entry. incl .pi 1 . ks.t . Incl .pi 1 . 1ock_array. Incl .pi 1 . 1 vt . Incl .pi 1 . 

mc. Incl. pit. nul1_addresses. Incl. pll. ptw. 168. Incl .pi 1 . pv_holdt . Incl .pi t . pvt . Incl .pi 1 . pvte. Incl .pi 1 . rnt. Incl. pit. 

scavenger_data. Incl. pit. scs. Incl .pi 1 . sdw. 168. Incl .pi 1 . sdw_lnf o, incl .pi t . signal ler_9tack. Incl .pi 1 . si t . Incl .pi t . 

site. incl. pit. sst.1nc1.pl1. sstnt . Incl .pi 1 . stack_0_data. Incl .pi t . 8tack_f rama. Incl .pi t . stack_header. Incl .pi t . 



stock_seg 



incl. pit, str. Incl. pit. tcm. Incl .pi t . vol_map. incl .pi t . vtoc_buf f er . Incl .pi 1 . vtoc_header . Incl .pi 1 , 
vloc_map. incl .pi 1. vtoca. incl .pl 1 . pds.cds. prds.cds. tc_data.cds 



Printed on: 
Printed by: 
Descriptor: 



04/01/83 0037.0 
SIbert.Multlcs.a 
mul tics 1 ibrar les_ 
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APPENDIX A 
Hardcore Include Files 



add type.1nc1.p1l •■ 1 vo1_map inci pi . 23 

aim'template.lncl.pn 2 vtoc_buff er. Inc .p - 24 

apti.1nc1.p1l 3 vtoc.header.lnc pll ...... 26 

aste.lnc1.p1l « vtoc_raap.inc1.p11 27 

bos_dump.lnc1.p11 8 vtoce.1nc1.p1l . - 128 

cmpTincl.pll ■'■' 

dbm.1nc1.p11 ^2 

dip_acl . Incl .pi 1 IS 

dlr_a1 1ocatlon_aPsa. incl .pi 1 . . 14 

d1r~entpy. incl -pM '•S 

d1r~header. Incl .pi 1 1"^ 

d1r~ht. incl .pi 1 • ■ '■^ 

d1r_Hnk. Incl .pi 1 20 

d1r~name. incl .pi 1 • ■ 22 

dirTockt. incl .pi 1 23 

dlsk_pack. incl .pi 1 24 

dskdcl . incl .pi 1 26 

ect_structures. incl .pi 1 .... 29 

event_wait_1 ist. incl .pi 1 .... 32 

faul t~vector. incl .pi 1 33 

fgbx.Tncl -pi 1 35 

fs_dev_types. incl -pi 1 36 

fs types; incl .pi 1 38 

fs~vo1 label . incl .pi 1 39 

hc~1ock. Incl .pi 1 '*'' 

itt_entpy. incl .pi 1 ^2 

kstTincl.pll ^3 

lock arpay. incl .pi 1 •*' 

1vt.Tncl.pl1 45 

mc. i nc 1 . p 1 1 *^ 

nul l_addpesses. incl .pi 1 .... 52 

pds . cds 53 

ppds.cds 54 

ptw. 168. incl .pi 1 72 

pv_hQldt. incl .pi 1 '3 

pvt . incl .pi 1 '4 

pvte. incl .pi 1 "^5 

pnt. incl .pi 1 "^^ 

scavengep_data. incl .pi 1 .... 79 

scs.incl.pl1 81 

sdw. 168. incl .pi 1 85 

sdw_info. incl .pi 1 86 

signal ler_stack. incl .pi 1 .... 87 

sit. incl. pll 88 

slte.mcl .pll 90 

sst.incl.pl1 92 

sstnt. incl. pll 98 

stack_0_data. incl .pi 1 99 

stack_frame. incl -pl 1 100 

stack_head6P. incl .pi 1 '•02 

stock~seg. incl .pi 1 ^04 

stp. incl. pll 107 

tc_data.cds 108 

tciii. incl .pi 1 H"^ 
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add_type. Inci .pi 1 



segment in: 

entry modi f led: 



> I dd> i nc 1 ude 
03/10/82 0836. 



contents modified: 09/16/77 0925.5 



/♦ BEGIN INCLUDE FILE add_type. i ncl . pi 1 ♦/ 
/♦ 02/26/75 by Bernard S. Greenbsrg */ 



/* 



This file provides a structure for checking 

PTW/CME address type fields in PL/1 */ 



del 1 add_type unaligned static Internal, 
2 core bit (-1) inlt ("1000"b), 
2 disk bit (4) inlt ("OtOCb), 
2pd bit (4) inlt ("OOIO"b), 
2 reserved bit (4) inlt ("0001"b), 
2 non null bit (4) intt ("111l"b); 



/• in core- S/B only In PTW ♦/ 

/* Disk address •/ 

/* Paging Device */ 

/* Reserved */ 

/♦ Not nul 1 address ♦/ 



del 1 badd_type unal Igned based, 

2 (core, disk, pd, reserved) bit (1) unaligned; 

/* END INCLUDE FILE add_type. Incl .pi 1 ♦/ 



includr '. hard. source 
F80A Dt to be reproduced 



add .type, tnc I .r 



ne 



alni_templlate . Inci .pi 1 



segment In: 
entry modifted: 



>ldd>*ric1ude 
03/10/8 2 0836. 



contents modified: I2/20/78 1614.1 



/» BEGIN INCLUDE FILE a1m_terap1ate. IncI .p» 1 ♦/ 

/♦ Created 740723 by PG */ 

/<• Modified 06/28/7B by C. D. Tavares to add rep privilege */ 

/* This structure defines the components of both an access 
class and an access authorization as Interpreted by the 
Access Isolation Mechanism. */ 



del 1 alm_template aligned based. 
2 categories bit (36). 
2 level fixed bin (17) unaligned. 
2 privileges unaligned, 
(3 ipc. 

3 dir. 

3 seg. 

3 soos, 

3 r I ng I , 

3 rep) bit (1). 

3 pad bit (12); 



/* authorization/access class template »/ 

/• access categories */ 

/♦ sensitivity level ♦/ 

/* special acceEiS privileges (In authorization only) •/ 

/* interprocess communication privilege */ 

f* directory privilege »/ 

/• segment privilege ♦/ 

/♦ security out-of -service privilege */ 

/* ring I access privilege */ 

/« RCP resource access privilege ♦/ 



/* END INCLUDE FILE a im_template. IncI .pi 1 »/ 



Include.**. Iiard. source 
F80A - Not to be reproduced 



a lm_template. IncI .pi 1 



Page 



apte. inci .pi 1 



segment In: 

entry rnodt f led: 



:> 1 dd> i nc 1 ude 
12/i5/82 M33.5 



contents modified: 12/15/82 1432.3 



/* BEGIN INCLUDE FILE 



apte. tnci .pi 1 ♦/ 



del aptep pointer; 

del 1 apte based (aptep) aligned, 

2 thread una! Igned, 
3 fp bit ( 18), 
3 bp bit ( 18), 

2 flags unaligned, 
3 mbz bit ( 1 ) , 
3 wakeup_wa1 ting bit (1), 
3 stop_pend1ng bit (1), 
3 pre_empted bit (1), 
3 hproc bit ( 1 ). 
3 loaded bit (1), 
3 el Iglble bit (1), 
3 Idle bit (1). 
3 Interaction bit (1), 
3 pre_einpt_pendlng bit (1), 
3 def aul t_procs_requ1red bit 
3 realt1me__bur9T b1 1 (1), 
3 always_roaded bit (1), 
3 dbrloaded bit (1), 
3 belng_loaded bit (1), 
3 shared_stacl<_0 bit (1). 
3 page_wa 1 t_f I ag b 1 t ( 1 ) , 
3 f Irstsw bit (1), 
3 state bit ( 18), 
pagefaults fixed bin (35). 
processid bit (36), 



(1). 



te f Ixed bin (35), 
ts fixed bin (35), 
t1 fixed bin (35), 
timax fixed bin (35), 

/♦*+*♦♦♦+♦/ 

2 1pc_po1nters unaligned, 

3 Qvent_thread bit (18), 

3 pads bit ( 18), 
2 1ps_mGssags bit (36). 
2 a-iteps unaligned, 

3 pds bit (18), 

3 dseg bit (18), 

3 prds bit (18). 
2 savex7 bit (18) unaligned, 
2 term processid bit (36), 



/♦ 'APT entry declaration for an active (known) process ♦/ 

/• List thread ♦/ 

/♦ Forward pointer ♦/ 

/* Backward pointer ♦/ 

/♦ Flags and miscellaneous ♦/ 

/♦ This bit must be zero (sentinel bit) */ 

/♦ ON If process has received wakeup ♦/ 

/♦ ON If process has received stop connect */ 

/• ON If process is being pre-empted by get_processor */ 

/♦ ON If process Is hardcore process ♦/ 

/♦ ON if required per-process pages are In memory and wired ♦/ 

/* ON If process Is eligible ♦/ 

/* ON if this Is an idle process */ 

/♦ ON if process has interacted recently */ 

/♦ ON if process has received pre-empt connect ♦/ 

/* ON if apte.procs_requlred Is system default •/ 

/♦ ON if next eligibility Is realtime ♦/ 

/• ON if process is not to be unloaded */ 

/♦ ON If DBR Is loaded on some CPU ♦/ 

/• ON If somebody loading this process •/ 

/♦ ON If a shared stack_0 Is assigned ♦/ 

/♦ flag ON If waiting for page */ 

/* OFF until process Is Intlalired ♦/ 

/♦ execution state */ 

/* total page faults for the process ♦/ 

/* bit 0-17: offset of ATPE ♦/ 

/♦ bit 18-35: sequential number ♦/ 

/♦ virtual time since eligibility award ♦/ 

/♦ virtual time since scheduling ♦/ 

/• virtual time since Interaction ♦/ 

/♦ maximum value allowed for apte.tl ♦/ 



/♦ relative pointer to ITT list ♦/ 

/♦ IPS signals pending */ 

/♦ relative ASTE pointers ♦/ 

/» PDS (per-process) »/ 

/• 05EG (per-process) ♦/ 

/* PRDS (per-processor ) ♦/ 

/♦ x7 at call to getwork (return point In pxss) 

/♦ process to send wakeup at temination ♦/ 



Include •• , hard, source 
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2 Jock_ld bit (36). 

2 time used clock ftxed bin (71), 



/* 



/* 



ji « # * ric « #/ 

wa1t_event btt (36) aligned. 
wct_1ndex bit (IB) unaligned, 
f 1ags2 una! Igned, 
3 pr lor I ty_3chedul Ing bit (1). 
3 spec1al_wakeups bit (6), 
3 pad? bit (7). 
3 batch bit (1). 
3 prtag bit (3). 
state_change_t Ime 
alarn)_ovent fixed 
alarm~tlme thread 



fixed bin (71). 

bin (71), 

bit (18) unal Igned, 



alarm time bit (54) unaligned. 



'/ 



term_channel fixed bin (71), 
ws_slze fixed bin, 
temax fixed bin (35). 
deadline fixed bin (71), 
lock bit (18) unaligned, 
unusable bit (18) unaligned. 



2 cpujnonltor fixed bin (35), 

2 paglng_meaBure fixed bin (71), 
2 access_authorlzat Ion bit (72), 
2 dbr fixed bin (71). 

2 vlrtual_cpu_t1ine fixed bin (71), 
2 lttes_sent fixed bin (18). 
2 lttes_got fixed bin (18), 

/* Cells used to drive and Instrument finite-state model 
measurement. Maintained by meter_response_t Ime */ 

a current_response_state fixed bin (17) unaligned. 

2 padlB bit (18) unaligned, 

2 number_processlng fixed bin (35). 

2 last_response_state_t Ime fixed bin (71), 

2 tota1_process1ng_t Ime fixed bin (71), 

/* 4( * * * * */ 

2 beg I n_ Interact I on_vcpu fixed bin (71), 

/* End of cells for finite-state model */ 

2 savedtemax fixed bin (35), 

2 procs_requlred bit (8) unaligned, 

2 apad (12) fixed bin (35); 



I* File System unqleu ID associated with process ♦/ 
/* Total CPU time when process last lost CPU ♦/ 



/» Event ID process awaiting •/ 
/* rel offset of WCTE ♦/ 

/* ON If guaranteed eligibility »/ 
/♦ Special wakciup channels »/ 

I* ON If absentee */ 

/* CPU tag running or last run */ 

/» Time apte.sitate last changed */ 

/♦ wakeup event for alarm clock manager */ 

/» thread of processes with pending alarms ♦/ 

/* wakeup time for alarm ♦/ 



/* wakeup event for account overflow */ 

/* working set estimate for the process •/ 

/* maximum eligibility slice (vcpu) */ 

/♦ time of next run ♦/ 

/♦ O -> APTE locked, unlocked •> return point of last unlock »/ 

/* locking routines destroy */ 

/* If not 0. s<snd wakeup to term_processld when virtual cpu 

/♦ reaches thin (units ■ 1/1024 sec) */ 

/♦ cumulative memory units ♦/ 

/* author Izatlisn of this process •/ 

/» DBR value (constant since DSEG entry-held) ♦/ 

/♦ cumulative virtual CPU time for the process ♦/ 

/« Unprocessed ITTs sent by this process */ 

/♦ Unprocessed ITTs received by this process ♦/ 

for response tiras 



/* Process state In modle »/ 

/• Number Interactions */ 

/* Clock time at last response state change »/ 

/• Total Interaction processing time •/ 



/» Virtual cpu at beginning of last Interaction */ 



/* temax at eligibility award ♦/ 

/* bit mask of CPUs this process can run ♦/ 



Include.**, hard. source 
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/* END JNCLUDE FILE ... apte.incl.plt ♦/ 



UicIudF ■■ . hard, source apte . )ncl . pi I 

FnoA it to be reproduced 



asto. tncl .pi i 



segment In: 

entry modi f led: 



>rdcl> tncUtde 

tt/ 116/82 1456.6 



contents modified: 11/16/82 1454.6 



/* BEGIN INCLUDE FILE ...aste.1ncl.pH ... ♦/ 

/♦ Template for an AST entry. Length = 12 words. ♦/ 

I* Words to 7. and 11 are read by PC; they are read and modlf led by SC. 



Words 8. 



9 and 10 are modified by PC; they should never be modified without locl<ing the PC locl< */ 



del astep ptr; 

del 1 aste based (astepj aligned. 

(2 fp bit (18), 
2 bp bit (18), 

• 2 inf 1 bit (18). 
2 infp bit (IB), 

2 strp bit < 18), 

2 par^astep bit (IB). 

2 uid bit (36), 

2 msl bit (9). 

2 pvtx f Ixed bin (8), 

2 vtocx fixed bin (17). 

2 usedf bit (1). 
2 Init bit (1), 
2 gtus bit (1), 
2 gtms bit (1). 
2 he bit ( 1 ) , 
2 hc_sdw bit ( 1 ). 
2 any_access_on bit (1), 
2 wr I te_access_on bit (1), 
2 1nhlblt_cache bit (1). 
2 expl Icl t_deact_ok bit (1), 
2 deact_error bit (1), 
2 hc_part bit ( I ), 
2 fm_damaged bit (1), 
2 pad I bit <3), 
2 dius bit ( 1). 
2 nid bit ( 1) , 
2 dmprpad bit (1), 
2 ehs bit ( 1 ) . 
2 nqsw bit ( 1 ), 
2 dirsw bit (1), 
2 master_dlr bit (1). 
2 volraap_seg bit (1). 
, 2 tqsw (O: 1) bit (1), 



/* forward used list rel pointer */ 
/• backward used list rel pointer */ 

/» ptr to NEia In list of ASTE's of my brothers »/ 
/* ptr to FIHST In list of ASTE's of ray children ♦/ 

I* rel pointer to process trailer ♦/ 
/♦ rel pointcar to parent aste •/ 

/* segment unique id */ 

/♦ maximum si3gment length in 1024 word units ♦/ 
/♦ physical volume table Index »/ 
/» vtoe entry Index ♦/ 

/* ast entry Is being used If non-zero */ 

/♦ used bit - Insure 1 lap »/ 

I* global transparent usage switch */ 

/♦ global transparent modified switch */ 

/* hard core segment »/ 

/* aste with sdw for hardcore seg if non-zero */ 

/» any sdw allows access, unless wr I te_acce3S_on »/ 

/» any sdw allows write access */ 

/* flag not to reset above bits »/ 

I* set If user can deactivate seg ♦/ 

/* set If error occurred while deactivating •/ 

/♦ set if pages are In a hardcore partition •/ 

/♦ set If fllemap checksum was ever bad ♦/ 

/* 00000 */ 

/» dumper In use switch »/ 

/♦ if on prevents addtlon to incremental dump map »/ 

/» entry hold switch «/ 

/* no quota switch - no checking for pages of this seg */ 

/* directory switch ♦/ 

/• master dir - a root for the log volume */ 

/♦ volmap_seg for some volume »/ 

/* terminal quota switch - (O) for non dir pages */ 
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2 padic bit ( 10), 
2 dtu b«t (36). 
2 dtm bit (36). 



/♦ Used to be aste.tc */ 

/* date and time segment last used */ 

/♦ date and tirae segment last modified */ 



2 quota (0:1) fixed bin (18) unsigned, 

2 used (0:1) fixed bin (18) unsigned. 

2 csl bit (g), 

2 f fflchanged bit ( 1 ) , 

2 fms bit ( O, 

2 npfa bit (1). 

2 gtpd bit (1), 

2 dnzp bit (1), 

2 per_proce8s bit (1). 

2 ddnp bit (1). 

2 pad2 bit (2), 

2 records bit (9). 

2 np bit ( 9 ) , 



/♦ sec storage quota - (0) for non dir pages */ 

/♦ sec storage used - (O) for non dtr pages */ 

/♦ current segment length In I024 words units */ 

/* turned on by page if file map changed ♦/ 

/* file modified switch ♦/ 

/* no page fault switch */ 

/* global transparent paging device switch */ 

/* don't null out If zero page switch ♦/ 

/* use master quota for this entry ♦/ 

/* don't deposit nulled pages */ 

/• number of records used by the seg In sec storage */ 
/* number of pages In core */ 



2 ht_fp bit (18). 

2 fmchangedl bit (1), 

2 damaged bit (1). 

2 pack_ovf 1 bit ( I). 

2 synchronized bit (1), 

2 pad3 bit (6), 

2 ptsi b1t(2), 

2 marker bit (6)) unaligned; 



/* hash table forward rel pointer */ 

/* value of "fmchanged" saved by pc$get_f I le_map ♦/ 

/♦ PC declared segment unusable ♦/ 

/* page fault on seg would cause pack overflow */ 

/♦ Data Management synchronized segment */ 

/♦ 000000000 ♦/ 

/♦ page table size Index ♦/ 

/♦ marker to Indicate last word of ASTE */ 



del asta (0 : 8000) bit (36*12 /* 88t-> sst.astsize */) based aligned; 



del 1 aste_part aligned based (astep), 

2 one bit (36) unaligned, 

a two bit (36*11 - 8) unaligned. 

2 three bit (6) unaligned; 



/♦ fp and bp ♦/ . 

/* part that has to be zeroed when ASTE is freed ♦/ 

/♦ ptsI and marker ♦/ 



del 1 seg^aste based (astep) aligned, 
2 padi bit (8*36), 
2 usage fixed bin (35), 
2 pad2 bit (3*36); 



/* 



END INCLUDE FILE ... aate. IncI .pll ♦/ 



/* Overlay because quota is only for dirs ♦/ 
/♦ page fault count: overlays quota ♦/ 



Include *, hard. source 
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bos dump, inci .pi II 



segment In; 

entry modi f ted: 



>ldd> Include 
03/10/82 0837.0 



contents modified: 09/08/81 1426. 4 



♦/ 



/* BEGIN INCLUDE FILE ... b03_dump. Incl .pi 1 

/<■ Modified 1 September 1976 »/ 

/* Modified «1/n/80 by d. A. Bush for the DPS8/70M CPU ♦/ 

/« Modified 6/12/81 by Rich Coppola to extend the dps8 extended fault reg to 

15 b1 ts •/ , , 

/» Modified 02/23/81. M. 01 In Sibert. to describe old and new FOUMP stylo!) •/ 



del dumpptr ptr; 

del 1 dump based (dumpptr) aligned, 

2 duiiipheader aligned like duinp_header , 

2 segs ( 1008). 

3 segno bit (18) unal . 
3 length bit (18) unal . 



2 amptwregs (0 
2 amptwptrs (O 
2 amsdwregs (O 



63) bit (36). 
63) bit (36), 
63) bit (72). 



2 amsdwptrs (0 : 63) bit (36). 

2 ouhlst (O : 63) bit (72). 

2 cuhlst (O : 63) bit (72), 

2 duhist (O : 63) bit (72), 

2 auhlst (O : 63) bit (72), 

2 prs (O : 7) ptr, 

2 regs aligned like dump_reg1sters . 

2 1ow_order_port bit (3). 
2 pad4 bit (36). 
2 mctlme fixed bin (52), 
2 pad5 (O : 3) bit (36), 

2 misc_registers like dump_mlsc_reg1sters , 
2 ptr 1 en (O : 7) bit (36). 

2 coreblocks (O : 7), 

3 nuin_flrst bit (18) unal. 

3 nuni blocks bit (18) unal, 
2 pad? (112) fixed bin; 



/♦ pointer to following structure ♦/ 
/» header of dump by fdump */ 

/* segment array •/ 

/♦ segment number */ 

/♦ length of segment in sector sized blocks */ 

I* assoc. mem, page table word regs ♦/ 

/* assoc. mem. page table word pointers */ 

/♦ assoc. mem. segment descriptor word registers ♦/ 

/• assoc. mem. segment descriptor word pointers */ 

/» operations unit history registers ♦/ 
/* control unit history registers */ 
/* decimal unit history registers */ 
/* appending unit history registers »/ 

/* pointer registers ♦/ 

/♦ assorted machine registers »/ 

/» from which clock Is read */ 

/♦ time conditions were taken ♦/ 

/» Assorted registers & processor data ♦/ 
/♦ pointers and lengths for EIS ♦/ 



/* first addr In coreblock •/ 
/» number of blocks used »/ 



del 1 dump_header aligned based, 
2 wordsdumped fixed bin (35), 
2 valid bit ( 1 ) , 



/* Standard header for FDUMP ♦/ 

/♦ total words in dump ♦/ 

/» = 1 if there Is a 6 180 dump to be had »/ 
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2 time fixed bin (71), 
2 erfno fixed bin (18), 
2 nui»_Begs fixed bin, 
2 val ld_355 bit (1). 
2 dumped_3558 bit (4), 
2 t1me_35S fixed bin (71). 
2 version fixed bin. 
2 padO (5) fixed bin; 

del 1 dunip_regl8ters aligned based, 
(2 X (0 : 7) bit (18). 
2 a bit (36), 
2 q bit (36), 
2 e bit (B), 
2 pad2 bit (28), 
2 t bit (27), 
2 pad3 bit (6). 
2 rair bit (3)) unaligned; 

del t durop_m1sc_registers aligned based, 
2 scu (O : 7) bit (36), 
2 mem (0 : 7) bit (72), 
2 dbr bit (72), 
2 Intrpts bit (36). 
2 bar bit (36). 
2 modereg bit (36), 
2 cmodereg bit (36), 
2 faultreg bit (36), 
2 ext_fau1t reg bit (15) unaligned, 
2 pad6 bit T21) unaligned; 



/♦ time of dump */ 

/♦ Error Report Form Number */ 

/• number of segments dumped */ 

/♦ " 1 If there Is a dn355 dump to be had */ 

/* Indicates which 355s were dumped */ 

/* time of 355 dump */ 

/♦ currently 2 •/ 

/* padO to 16 words ♦/ 

/♦ Standard (SRE6) arrangement of registers in dump •/ 

/♦ Index registers ♦/ 

/* the a regls-ter ♦/ 

/♦ the q register ♦/ 

/♦ the e register ♦/ 

/♦ pad */ 

/♦ timer register ♦/ 

/* pad ♦/ 

/♦ ring alarm register ♦/ 



/♦ from store control unit Instr. */ 

/♦ memory controller masks every 64 K ♦/ 

/* descriptor segment base register ♦/ 

/* Interrupts */ 

/* base address register ♦/ 

/» mode register */ 

/* cache mode register */ 

/♦ fault register ♦/ 

/* DPSB extended fault register ♦/ 



del 1 v1_dump aligned based (dumpptr), 

2 dump_header aligned like dump_header. 



segs (688), 

3 segno bit (18) unal, 

3 length bit ( 18) unal , 



2 amsdwregs (0 

2 amsdwptrs (0 

2 amptwregs (O 

2 araptwptrs (0 



IS) bit (72), 

15) bit (36), 

IS) bit (36). 

15) bit (36), 



2 padi (O : 15) bit (36), 

2 ouhlst (0 : 15) bit (72), 

2 cuhlst (O : 15) bit (72), 

2 auhlst (0 : 15) bit (72), 

2 duhlst (O : 15) bit (72), 

2 prs (O : 7) ptr, 

2 regs aligned like dump_reglsters. 



/* Old version of FDUMP (pre March, 1981) •/ 



/* segment array */ 

/* segment number ♦/ 

/* length of segment In sector sized blocks */ 

/♦ assoc. mem. segment descriptor word registers */ 

/♦ assoc. mem. segment descriptor word pointers ♦/ 

/» assoc. mem. page table word regs */ 

/* assoc. mem. page table word pointers */ 



/* operations unit history registers */ 
/♦ control unit history registers */ 
/* appending unit history registers */ 
/♦ decimal unit history registers */ 

/♦ pointer registers */ 

/♦ assorted machine registers ♦/ 



Includr *, hard. source 
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bos_dump. Inci .r 



IB 



2 ™ctime fixed bin (52). /• I Ime condtl Ions were taken ./ 

2 pad4 (O : 5) bJt (36). 

2 nilsc_regtsters aligned like dump_misc_reglsters, /' Aasorled ragistens ♦/ 

2 pad5 bit (36). , . ■ . *, t , cic »/ 

2 ptrlen (O : 7) bit (36). /* pointers and lengths for EIS *l 

\ ?rorder_port*bH-(3). /* f-. which clock was read •/ 

' r^r^'l(. na) uoal. /. Mrst -f ^J-oroblock ./ 

3 nuinlblocks bit (1B) unal; /• "umber of blocks used ./ 

del DUMP_VERSI0N_1 fixed bin internal static options (constant) init (1): 

del DUMP_VERSI0N_2 fixed bin internal static options (constant) Init (2); 

/* END INCLUDE FILE ... bos_duinp. incl .pi 1 ... */ 



Tr7clude.»^ . hard . source bos_dump . 1 nc 1 . p M 
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cmp. Inci .pi 1 



segment In: > 1 dd> t nc Hide 

entry modif ted: »t/19/B2 1604.3 



contents modified: 11/19/82 1602.1 



/♦ BEGIN INCLUDE FILE cmp. IncI .pll October 1982 */ 

/* Note: This Include file has an ALM counterpart NOT made with ctf (for historical reasons). Keep It up to date */ 



del cmep ptr; 

del 1 erne based (cmep) aligned, 
2 fp bit (ia) unaligned, 
2 bp bit (18) unaligned, 

2 devadd bit (22) unaligned, 

2 pads bit (1) unaligned, 

2 Bynch_he I d b 1 1 ( 1 ) una 1 I gned , 

2 lo bit (1) unaligned, 

2 pads bit (1) unaligned, 

2 er bit (t) unaligned. 

2 removing bit (1) unaligned, 

2 abs_w bit (1) unaligned, 

2 abs_u8ab1e bit (1) unaligned, 

2 not lfy_requestGd bit (1) unaligned, 

2 pad3 bit (1) unaligned, 

2 phm_hedge bit (1) unaligned, 

2 contr bit (3) unaligned, 

2 ptwp bit (IB) unaligned, 

2 astep bit (18) unaligned, 

2 pln_counter fixed bin (17) unaligned, 

a synch_page_entryp bit (18) unaligned; 



/• pointer to core map entry */ 

/♦ core map entry */ 

/♦ forward pointer to next entry */ 

/* backward pointer to previous entry */ 

/* device address of page In the core block */ 

/* Page of synchronized seg held In memory */ 

/* input/output indicator l=output. 0= Input */ 



/* 
/■> 
/* 
/• 

h 



Indicates error in previous 10 activity ♦/ 
core 13 being removed by reconfiguration */ 
absolute address must not be changed for page */ 
page may be assigned with fixed absolute address ♦/ 
not If y requested on I/O completion */ 



/* on «> pc$f lush_core ought write. */ 

/* controller in which core block Is located */ 

/♦ pointer to page table word for the page */ 

/* relative AST entry pointer of page */ 

/* number of times to skip eviction */ 

/* relp to synch .page entry ♦/ 



del 1 cma (0: 1) based aligned like cme; 

del 1 mcme based (cmep) aligned, 
2 pad bit (36) unaligned, 
2 record_no bit (IB) unaligned, 
2 add_type bit (4) Unaligned. 
2 flags bit (14) unal. 
2 padi bit (18) unal; 



/♦ Core map array */ 

/* core map entry for extracting DID */ 

/* record number of device ♦/ 

/♦ see add_type. incI .pi 1 */ 



/* END INCLUDE FILE cmp. IncI .pi 1 */ 



Include '♦, hard. source 
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P^ge 



1 1 



dbm . J nc 1 .pi 1 



segment )n: > ldcl> Include 

entry modified: O5/2O/02 1047.5 



contents modified: 05/20/82 1037.5 



/» BEGIN INCLUDE FILE 



dbm . i nc I . p I 1 



Feb 1976 */ 



dc 1 dbm_seg$ ex t ; 
del dbmp ptr; 

del 1 dbm based (dbmp) aligned, 

2 1ock_data. 

3 lock bit (36), 
3 event bit (36), 
3 notify bit (1). 

2 control . 

3 Intt bit ( O unal . 
3 padi bit (35) unal . 

2 stats, 

3 sets fixed bin una), 
3 resets fixed bin unal, 
3 allocs fixed bin una), 
3 frees fixed bin una), 

2 pad2 (2) bit (36), 

2 area area (255*1024 -8): 



/♦ END INCLUDE FILE 



dbm.lncl.pll ♦/ 



Include.**, hard. source 
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d i r_Bc 1 . 1 nc I . p I 1 



segment )n: 

entry modi f ted: 



> I dd> I nc I ude 
03/10/82 0836.4 



contents modified: 02/24/76 1923.4 



/* BEGIN INCLUDE FILE ... dlr_ac1 . Inci .pi 1 ... last modified Nov 1975 for nss ♦/ 
/• Template for an ACL entry. Length » 8 words */ 
del aclep ptr; 



do) 1 acl_entry based (aclep) aligned, 
2 frp b1t(18]l unaligned. 
2 brp btt(t8) unaligned, 

2 type bit (IB) unaligned, 

2 size fixed bin (17) unaligned. 



/♦ length Is 8 words ♦/ 

/♦ rel ptr to next entry ♦/ 

/♦ rel ptr to previous entry */ 

/« type ' dir acl •/ 

/* size of acl entry */ 



2 name unaligned, 

3 pers_rp bU(18) unaligned. 
3 proJ_rp b1t(18) unaligned, 
3 tag char(1) unaligned.' 

2 mode bit (3) unaligned. 

2 pad24 b1t(24) unaligned. 

2 ex__mode bit (36), 

2 checksum bit (36), 
2 owner bit (36); 



/* user name associated with this ACL entry */ 

/• name of user ♦/ 

/* project of user ♦/ 

/* tag of user ♦/ 

/• mode for user Id */ 



/* extended access modes */ 

/♦ checksum from acl_entry . name ♦/ 
/* uld of owning entry ♦/ 



/♦ Template for a person or project name on .ACL. Length » 14 words. */ 



del 1 access_name aligned based, 
2 frp b1t(18) unaligned, 
2 brp blt(18) unaligned. 

2 type bit (US) unaligned. 

2 size fixed bin (17) unaligned. 

2 salv_flag fixed bln(17) unaligned, 
2 usage fixed bln(l7) unaligned. 

2 pad! bit (36), 

2 name char(32) aligned, 

2 checksum bit (36), 

2 owner bit (36); 

/* END INCLUDE FILE ... dlr_acl , Incl .pi 1 */ 



/* person or project name */ 

/* rel ptr to next name structure */ 

/* rel ptr to prev name structure ♦/ 

/* type " access name */ 
/* size of access name */ 

/♦ used by salvager to check for asci 1 names */ 

/♦ number of ACL entries that refer to this name */ 



/♦ person or project name Itself */ 

/» checksum from salv_flag */ 

/* uld of containing directory ♦/ 



Includf •, hard. source 
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djr al locat 1on_area. inci .pll 



segment In: 

entry modf f ied: 



> 1 clcl> t nc I ude 
03/ 10/82 0836.6 



contents modified: 09/22/76 1439,9 



BEGIN INCLUDE FILE 



dlr allocation area. Incl .pi 1 



del areap ptr: 

del 1 area based (areap) aligned, 
2 nsizes fixed bin (18), 
2 1u fixed bin (18), 
2 Iw fixed blp (18). 
2 array (100) aligned, 

3 fptr bit (18) unaligned, 

3 size fixed bin (17) unaligned; 



last, modified December 1973 ♦/ 



/♦ Number of types. ♦/ 

/* Next available word In area. »/ 

/♦ Last usable word. »/ 

/♦ Array of types. •/ 

/♦ Free pointer for this size. ♦/ 

/♦ Size. ♦/ 



END INCLUDE FILE 



dlr al locat lon_area. Incl .pi 1 */ 



Include.**, hard. source 
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dir_entry . Incl .pi 1 



segment in: >1dd> Include 

entry rood I (Med: 03/«0/8a 0836.5 



contents modified: 04/26/76 1720. O 



/• 



BEGIN INCLUDE FILE 



dlr_entry . Incl .pi 1 



last modified August 1974 for nss */ 



/* Template for an entry. Length • 38 words */ 

del ep ptr; 

del 1 entry based (ep) aligned, 

(2 efrp bit C 18). 

2 ebrp bit ( 48) ). unal Igned. 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned, 

2 uld bit (36). 

2 dtera bit (36). 

(2 bs bit (4). 

2 padO bit (17). 

2 nnames fixed bin (47). 

2 nattie_frp bit (18), 
2 narae_brp bit (18), 

a author, 

3 pers_rp bit (18). 
3 proJ_rp bit ( 18). 

3 tag char ( 1 ) , 
3 padi char (3) , 

2 prlniary_narae bit (504), 

2 dtd bit (36), 

2 pad2 bit (36). 



/♦ forward rel ptr to next entry */ 

/* backward rel ptr to previous entry */ 

/♦ type of object = dir entry »/ 

/♦ size of dir entry •/ 

/♦ unique Id of entry */ 

/♦ date-time entry modified ♦/ 

/♦ branch switch = 1 If branch ♦/ 

/♦ number of names for this entry ♦/ 

/♦ rel pointer to start of name list ♦/ 

/♦ rel pointer to end of name list */ 

/* user who created branch ♦/ 

/♦ name of user who created branch */ 

/♦ project of user who created branch */ 

/* tag of user who created branch ♦/ 

/♦ first name on name list */ 

/* date time dumped ♦/ 



/* the declarations below are for branch only */ 



2 pvid bit (36). 

2 vtocx fixed bin ( 17), 
2 pad3 bit (18), 

2 dtrsw bit (1), 



/* physical volume Id ♦/ 
/* vtoc entry Index */ 

/* = 1 If this Is a directory branch ♦/ 



Include ♦, hard. source 
"'OA pt to be reproduced 
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2 oosw bit < I ) . 

2 per_process_sw b)t (1), 

2 copysw bit (»). 

2 safetysw bit ( 1 ) . 

2 mult tp)e_c1ass bit (1). 

2 audi t flag bit (1), 

2 securl ty_oosw bit (1). 

2 entrypt_sw bit (1). 

2 masterdU- bit ( t ), 

2 tpd bit < 1), 

2 pad4 bit (11). 

2 entrypt_bound bit (14)) unaligned. 

2 access_class bit (72) aligned, 

(2 rlng_brackets (3) bit (3). 
2 ex_ring_bracl<Bts (3) bit (3). 
2 acle count fixed bin (17). 

2 acl_frp bit ( 18), 
2 acl_brp bit (18), 

2 bc_author. 

3 persrp bit (18), 
3 proj_rp bit ( 18) . 

3 tag char ( 1 ) . 
3 pad5 bit (2), 
2 be fixed bin (24)) unaligned. 



2 sonslvid bit (36). 
2 pad6 bit (36). 
2 checl<sum bit (36), 
2 owner bit ( 36 ) ; 

END INCLUDE FILE 



/♦ out of service switch on = I •/ 

/* indicates iseginent is t>ei- process •/ 

/♦ = 1 make copy of segment whenever Initiated ♦/ 

/» I f ■ 1 then entry cannot be deleted »/ 

/• segment haii multiple security classes »/ 

/♦ segmeift mu;3t bo audited for security »/ 

/♦ security out of service switch ♦/ 

/♦ 1 If call llmlter is to be enabled ♦/ 

/♦ TRUE for master directory «/ 

/» TRUE If this segment is never to go on the PD •/ 

/* cal 1 I Imltisr */ 

/» security attributes : level and category »/ 

/* ring brackets on segment ♦/ 
/* extended ring brackets •/ 
/• number of entries on ACL */ 

/* rel ptr to start of ACL •/ 
I* rel ptr to end of ACL ♦/ 

/* user who last set the bit count •/ 
/» name of user who set the bit count »/ 
/♦ project of user who set the bit count •/ 

/* tag of user who set the bit count •/ 

/♦ bit count for segs, msf indicator for dirs »/ 

/» logical volume Id for Immedlat Inf non dir seg »/ 



/* checksum from dtd »/ 

/* uld of containing directory •/ 



dlr^entry. IncI .pi 1 



include. •». hard. source 
F80A - Not to be reproduced 
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dlr_header. <ncl .pi 1 



segment )n: > 1 dcl> ) nc I ude 

entry modtfled: 05/12/82 1254.5 



contents modllf led; 05/12/82 1246.4 



/* BEGIN INCLUDE FILE ... dir header . Incl .pi 1 */ 

/* Modified 8/74 for NSS ♦/ 

/♦ Modified 8/76 to add version number and hash table rel pointer for variable hash table sizes */ 

/♦ Modified 3/82 BIM for change pclock */ 

/* format: styles */ 

/+ Template for the directory header. Length • 64 words. */ 

del dp ptr; 

del 1 dIr based <dp) aligned. 



2 modify bit <36), 
2 type bit (18) unaligned, 
2 size fixed bin (17) unaligned, 
2 dtc (3). 

3 date bit (36), 

3 error bit (36), 

2 uld bit (36), 

2 pvid bit (36), 

2 sons_lv1d bit (36), 

2 access_class bit (72), 

(2 vtocx fixed bin (17), 

2 versJon_nuraber fixed bin (17).' 

2 entryfrp bit (18), 
2 pad2 bit (18), 

2 entrybrp bit ( IB), 
2 pad3 bit (18). 

2 pers_frp bit (18), 
2 proJ_frp bit (18), 

2 pers_brp bit (18), 
2 proJ_brp bit (18), 

2 seg_count fixed bin (17), 
2 dlr_count fixed bin (17), 

2 Icount fixed bin (17), 

2 acle_total fixed bin (17), 

2 arearp bit ( 18) , 



/♦ Process ID of last modifier ♦/ 
/* type of object • dir header */ 

/♦ size of header In words ♦/ 

/♦ date-ttme checked by salvager array ♦/ 

/* the date ♦/ 

/♦ what errors were discovered */ 

/♦ uld of the directory - copied from branch ♦/ 

/* phys vol Id of the dlr - copied from branch */ 

/* log vol Id for Inf non dlr seg - copied from branch ♦/ 

/* security attributes of dlr - copied from branch •/ 



/♦ vtoc entry Index of the dlr 
/♦ version number of header */ 



- copied from branch ♦/ 
/* rel ptr to beginning of entry list •/ 
/* rel ptr to end of entry list */ 



/• rel ptr to' start of person name list ♦/ 
/* rel ptr to start of project name list */ 

/» rel ptr to end of person name list ♦/ 
/♦ rel ptr to end of project name list */ 

/* number of non-directory branches ♦/ 
/* number of directory branches ♦/ 

/♦ number of links •/ 

/* total number of ACL entries In directory ♦/ 

/* relative pointer to beginning of allocation area ♦/ 



Includf ■, hard. source 
''O* lot to be reproduced 
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2 per_process_sw bit (1). 
2 mastercUr bit (1), 
2 force_rpv bit (1). 
2 rehashing bit (1). 
2 pad4 bit ( i4), 

2 lacl_count (0:7), 
3 seg f ixed bin (17), 
3 dtr fixed bin (17). 

2 taci (0:7). 

3 seg_frp bit (18). 
3 segbrp bit ( 18). 

3 dir_frp bit ( 18). 
3 dir_brp bit ( 18) , 

2 htsize fixed bin (17). 
2 hash_tab1e_rp bit (18). 

2 htused fixed bin (17). 
2 pad6 f ixed bin < 17) . 

2 tree_depth fixed bin (17), 
2 pad7 bit (18)) unaligned. 

2 dts bit (36). 

2 master_dir_uld bit (36). 

2 change_pc i ock fixed bin (35), 

2 pad8 (II) bit (36). 

2 checl<suiu bit (36), 

2 owner bit (36) ; 

del version_nun)ber_2 fixed bin Int 

/♦ END INCLUDE FILE ... dlr_ 



/♦ Indicates dir contains per process segments ♦/ 

/» TRUE If this Is a master dIr ♦/ 

/♦ TRUE If sejis must be on RPV »/ 

/♦ TRUE if hasih table Is being constructed ♦/ 



/♦ number of iinltlal acl entries for segs */ 
I* number of unltlal acl entries for dIr »/ 

/* pointer to initial ACLs for each ring •/ 
/* rel ptr to start of initial ACL for segs »/ 
/♦ rel ptr to end of initial ACL for segs ♦/ 

/* rel ptr to start of initial for dirs »/ 
/♦ rel ptr to end of Initial ACL for dirs ♦/ 

/* size of hajih table »/ 

/» rel ptr to start of hash table »/ 

/» no. of used places In hash table */ 



/♦ number of levels from root of this dir ♦/ 



/♦ date-time directory last salvaged ♦/ 

/» uid of superior master dIr »/ 

/* up otie each call to sum$dlrmod ♦/ 

/♦ pad to mako I t a 64 word header ♦/ 

/* check summed from uid on •/ 

/* uid of parisnt dir ♦/ 



static options (constant) Init (2); 
header. incT .p1 1 ♦/ 



include. ♦♦. hard. source 
F80A - Not to be reproduced 
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dlr_ht. inci .pi ( 



segment In: 
entry mod if ted: 



> I dd> ( nc \ ude 
03/10/82 0836.5 



contents modified: 10/19/76 1420.6 



/* 



BEGIN INCLUDE FILE 



d«r_ht. inci .pll */ 



del htp ptr; 

del t hash table based (htp) aligned, 
2 modify bit (36) unal. 
2 type bit (10) unal. 
2 size fixed bin (17) unal, 
2 naine_rp (0:1) blt(16) unal, 
2 checksum bit (36) unal, 
2 owner bit (36) unal; 



/• 



/♦ htp = ptr(dp,act1ve_hardcore_data$htrp) */ 

/♦ type " dlr hash table ♦/ 

/♦ size bf current dlr hash table entry */ 

/* rel ptr of name entry ♦/ 



/♦. otherwise rel ptr to name */ 



END INCLUDE FILE 



dlr_ht. Incl.pl 1 ♦/ 



1 nc 1 ude * , hard . source 
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dtr I Ink . (nc) .pi 1 



segment in: >1dol>«ncUide 

entry modified: O7/30/B2 1442.9 



contents modified: 02/24/76 1923.5 



last modified August 1974 for nss */ 



/♦ BEGIN INCLUDE FILE ... dlr_nnk . Incl .pi 1 

/♦ Template for Hnk. Note that It Is Identical to entry for first 24 words. */ 



del 1 Hnk based (ep) aligned. 

(2 efrp bit ( 18). 
2 ebrp bit ( 18), 

2 type bit (18), 

2 size fixed bin < 17) , 

2 uld bit (36). 

2 dtem bit (36), 

2 bs bit (1). 

2 padO bit (17), 

2 nnames fixed bin (17), 

2 narae_frp bit (18). 
2 nanie_brp bit (18). 

2 author, 

3 per8_rp bit ( 18), 
3 proJ_rp bit (18), 

3 tag char ( 1 ) , 
3 padi char (3), 

2 pr1mary_naroe bit (504). 

2 dtd bit (36). 

2 pad2 bit (36). 



/* forward rel ptr to next entry */ 

/♦ backward rel ptr to previous entry */ 

/* type = dir 1 Ink ♦/ 

/♦ size of link In words ♦/ 

/» unique id cif entry */ 

/♦ da'te-tlme tsntry modified ♦/ 

/♦ entry switch = 1 If entry */ 

/♦ number of names for this entry */ 

/♦ rel pointer to start of name list */ 
/* rel pointer to end of name list */ 

/♦ user who created entry »/ 

/* .name of us«r who created entry */ 

/* project of user who created entry ♦/ 

/* tag of user who created entry ♦/ 

/♦ first name on name list •/ 
/« date time (Jumped */ 



/♦ the declarations below are only applicable to links */ 

2 pad3 bit ( 18) , 

2 pathnamesize fixed bin (17). 



/* number of characters In pathname ♦/ 



2 pathname char (168 refer (pathname_s1ze) ) ) unaligned. /» pathname of link ♦/ 



pa 

2 checksum bit (36), 
2 owner bit (36); 



/♦ checksum from uld */ 

/* uld of containing directory */ 



Include.**, hard. source 
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/♦ END INCLUDE FILE ... d1r_nnk. Incl .pi 1 ♦/ 



Include *, hard. source d1r_1 Ink. Incl .p' ' p-qe 21 

ot to be reproduced 



dir name. inci .p) 1 



segment In: >1dd> Include 

entry modified: 03/10/82 0836.5 



contents modified: 10/19/76 1420.6 



/» BEGIN INCLUDE FILE ... dlr_name. Incl .pi I ... last modified Nov 1975 for nss ♦/ 
/» Template for names of branches or links. Length = 14 words. */ 
del np ptr; 



del 1 names based aligned. 
2 fp bit(ia) unaligned. 
2 bp blt(l8) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned, 

2 entry_rp blt(IB) unaligned, 

2 ht_lndex fixed b1n(17) unaligned, 

2 hash_thread bit (18) unal , 
2 pad3 bit (IB) unal . 

2 name char(32) aligned, 

2 checksum bit (36). 

2 owner bit (36); 



/* based on ptr(dp,ep->entry . name_f rp) ♦/ 

/* rel ptr to next name »/ 

/• rel ptr to .prov name •/ 

'I* type » dIr name ♦/ 

/♦ size of dlr name ♦/ 

/* rel ptr to entry */ 

/* Index of hash table entry */ 

/* relative ptr to next hash entry ♦/ 



/* checksum from entry_rp ♦/ 
/* uld of entry ♦/ 



/* 



END INCLUDE FILE 



dlr name. Inc) .pi 1 »/ 



Include. ♦♦, hard. source 
FftAA - Wnt tn be renroduced 
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dirlockt. <ncl .pi 1 



segment In: 
entry modilfled: 



>1dd>1nc)ude 
03/09/B3 H0 1.4 



contents modified: 03/09/83 1400.0 



/* BEGIN INCLUDE FILE dirlockt . Inci .pll 

/* Modified BIM 1/83 cleanup to multi-read lock */ 

/♦ format: styles. 1dlnd2S */ 

del dlr1ockt_seg$ ext; 

del dirlocktp ptr; 



♦/ 



/* name of the segment containing the directory locks ♦/ 
/* pointer to the dirlock table */ 



del . 


1 dirlockt 




2 lock 




2 Ind 




2 notify sw 




2 last 




2 h1ghe8t_last 




2 counter 




2 dirlock 


declare 


dir lock ptr 


declare 


1 dir lock 




2 pid 




2 Ind 




2 notlfy_sw 




2 salvage sw 




2 padi 




2 lock count 



based (dirlocktp) aligned. 



bit (36), 
fixed bin (35), 
bit (1). 
fixed bin 
fixed bin 
(1:59) f1 
(1:10000) 



/* Table of locks for dlrecyorles */ 
/* Lock for the table Itself */ 
/* Event for the above lock */ 



(17), /* Index of the last entry currently used ♦/ 

(17), /* Highest Index ever used */ 

xed bin (35), /* count(l) • number of times entry 1 was used 
aligned like d1r__lock; 

/*' entry for a directory lock ♦/ 



♦/ 



pointer; 

aligned based (d1r_lock_ptr 



/* END dirlockt. Ind. pll 



bit (36), 
bit (36) aligned, 
bit ( 1 ) unal Igned, 
bit (1) unal Igned. 
bit (34) unal Igned, 
fixed bin (35): 



♦/ 



/* 
/* 
/* 
/* 

/* 
/* 
/* 



). 

pid of the process that locked the dir for write ♦/ 
uld of the directory - also used as event Id */ 
ON If one or more processes are waiting for the lock ♦/ 
ON If dir was locked for salvage ♦/ 

POSITIVE --> wr1te_lock ♦/ 
NEGATIVE --> -number of lockers */ 
ZERO --> not locked ♦/ 



include ■, hard. source 

Jot to be reproduced 
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disk_pack. IncJ .pi 1 



/* 



segment " in: 
entity modified: 



> I dd:- i nc 1 ude 
05/20/82 1047.6 



contents modified: 05/20/82 1037.5 



BEGIN INCLUDE F ILE . . . di sl<_pack . Incl .pH 



Last Modified .January 1982 for new volume map ♦/ 



/♦ 



All disk packs have tlie standard layout described below: 

contains the label, as declared In f8_vol label . Incl .pi 1 . 
contains the volume map, as declared in vol_roap. incl .pi 1 
contains the dumper bit map. as declared In dumper_bi t_map. incl .pi 1 
contains the vtoc map. as declared In vtO(3_raap. Incl .pi 1 
formerly contained bad track list; no longer used, 
contain the array of vtoc entries; ( n Is specified In the label) 
each record'conta ins 5 192-word vtoc entries. The last 64 words are unused. ,»h=H 

Records n to N- 1 : contain the pages of the Multics segments. ( N is specified In the label) 

Sundry partitions may exist within the region n to N-1. withdrawn or not as befits the meaning 
of the particular partition. 



Record 


O 




Record 


1 


to 3 


Record 


4 


to 5 


Record 


6 




Record 


7 





Records 8 to n- 1 



A conceptual declaration for a disk pack could be: 



del 1 d1sk_pack, 

2 label_record 

2 volume_iiiap_record 

2 dumper_b 1 t_map_record 

2 vtoc_map_record 

2 spare_record 

2 vtoc_array_records 

3 vtoc_entry ( 5 ) 
3 unused 

2 Mul t 1cs_pages_records 



(0 


0) 


(1 


3> 


(4 


5) 


(6 


6) 


(7 


7) 


(8 


n-1) 



(n : N-1) 



blt(36 
blt(36 
b1t(36 
b1t(36 
b1t(36 



1024). 
1024). 
1024). 
1024), 
1024). 



b1t(36 * 192). 
b1t(36 * 64). 
blt(36 ♦ 1024); 



*/ 



del 



(LABEL_AOOR 
VOLMAP_ADDR 
DUMPER_B I T_MAP_ADDR 
VTOC_MAP_ADDR 
VT0C_0RIGIN 
SECTORS_PER_VTOCE 
VTOCES_PER_RECORO 
DEFAULT_HCPART SIZE 
MAX VTOCE PER PACK 



Inlt (O). 
Init (1). 
Inlt (4). 
Inlt (6). 
Inlt (8). 
init (3). 
Inlt (5), 
1n1t*(1000), 
inlt (31774)) 
fixed bin ( 17) 



/* 
/♦ 
/♦ 
/» 
/* 



/ 



Int static options (constant) 



Address of Volume Label */ 
Address of first Volume Map record ♦/ 
For Initial release compai t Ibl 1 ty ♦/ 
Address of first VTOC Map Record ♦/ 
Address of first record of VTOC ♦/ 



Size of Hairdcore Partition */ 
Limited by size of VTOC Map ♦/ 



Include.**, hard. source 
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/* END INCLUDE FILE. . .oH8k_pack. Inci .pll ♦/ 



inctudc ♦, hardisource dl 8k_pack . I nc I . • « '^le 25 

jt jlot to be reproduced 



dskdc) . Incl .pi 1 



segment In: 

entry modified: 



>1dd> Include 
08/17/82 1426. 



contents modified: 08/17/82 1421.1 



/* Begin Include file dskdcl . Incl .p11 */ 

/♦ Structures used by the Disk DIM */ 

/* format: sty »e4,delnl , Insnl . tree, 1 fthenstmt , tndnontterend */ 



del dlsk_seg$ ext ; 

del disksp ptr. 
diskp ptr; 

dc! 1 d1sk_data based (disksp) aligned. 
2 subsystems fixed bin, 
2 freo_offset bit ( 18). 
2 status_mask bit (36). 
2 last_queue_t trae fixed bin (71). 
2 pad (2) fixed bin. 
2 array (32), 

( 

3 offset bit (18). 

3 pad bit ( 18). 

3 name char ( 4 ) 

) una I ; 

del 1 disktab based (dIskp) aligned, 
2 lock bit (36) unal . 
2 nchan fixed bin, 
2 ndrlves fixed bin, 
2 channel8_onl Ine fixed bin, 
2 devbusy bit (64). 
2 dev_queued bit ( 64 ) , 
2 wq (0:1) 1 Ike qht . 
2 f ree_q 1 ike qht , 

2 abs_raem_addr fixed bin (26) unsigned, 
2 pad fixed bin. 
2 errors fixed bin. 
2 f errors fixed bin. 
2 edac_errors fixed bin, 
2 pg_1o_count (0:1) f l-.xed bin, 
2 vt_1o_count (0:1) fixed bin. 
2 cal I_lock_meters like d1sk_lock_meters, 
2 1nt_lock_meters 1 ike disk_lock_roeters. 
2 anoc_wait_meters like dlsk_lock_raeters , 
2 run_lock_raeters like d1sk_lock_meters. 
2 pg_walt (0:1) fixed bin (52). 
2 vt_wa1t (0:1) fixed bin (52). 
2 pg_lo (0:1) fixed bin (52). 
2 vt_lo (0:1) fixed bin (52). 
2 queue (64) like quentry. 
2 chantab (8) like chantab. 



/♦ disk data segment ♦/ 

/♦ pointer to disk subsystem info */ 

/» pointer to disk DIM Info structure ♦/ 

/♦ disk subsystem information */ 

/♦ number of subsystems */ 

/* offset of first unused location In segment */ 

/* mask for checking for disk error »/ 

/♦ for dump analysis, to interpret times ♦/ 

/* per subsystem info */ 

/* location of data for this subsystem */ 

/♦ name of subsiystem ♦/ 

/* control structure for DIM's */ 

/* data base lock */ 

/* number of disk channels ♦/ 

/* highest disk drive number */ 

/♦ number of dl sk- channels actually in use */ 

/* busy bit for each device */ 

/♦ requests queued bit for each device */ 

/♦ wait queue head/ tail */ 

/» free queue liead/tall */ 

/* absolute memory address of this structure */ 

/* error count ♦/ 

/» fatal error count */ 

/♦ count of EDAC correctable errors ♦/ 

/* count of page I/O operations */ 

/* count of VTOCE I/O operations */ 

/* lock maters for call side of DIM */ 

/♦ lock maters for Interrupt side of DIM */ 

/♦ meters for queue entry allocations ♦/ 

/♦ lock meters for run calls *l 

/* total time ispent waiting for page I/O */ 

/♦ total time sipent waiting for VTOCE I/O */ 

/* total time iipent doing page I/O ♦/ 

/+ total time iipent doing VTOCE I/O ♦/ 

/* queue entries ♦/ 

/* channel Information table */ 



include.**, hard. source 
FBOA - Not to be reproduced 
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2 devtab (O refer (dlsktab.ndrlves) ) like devtab; 
%page; 

del qp ptr, 
cp ptr; 



/* device information table ♦/ 



del t quentry based (qp) a1 Igned, 
( 

2 next bit (IB), 
2 wrlte^sw bit ( 1), • 
2 sect_SM bit ( 1 ). 
2 testing bit ( t), 
2 retry bit (1). 
2 used bit (1), 
2 swap bit (1), 
2 cylinder fixed bin (11), 
2 pdl unsigned fixed bin (6), 
2 coreadd bit (24), 
2 dev unsigned fixed bin (6), 
2 sector bit (21), 
2 pad bit (9). 

2 n_8ector8 fixed bin (6) unsigned, 
2 time fixed bin (36) unsigned 



del 1 chantab based (cp) aligned, 
2 chx fixed bin (35). 
1ol_ctx fixed bin (35), 
staTusp ptr, 
chanid char (B), 



padO bit (IB), 
1 n_u8e bit ( 1 ) , 
active bit (1). 
rsr bit (1), 
prior bit (1), 
1ol_use bit (1). 
Inop bit (1), 
broken bit (1), 
action code bit (2), 
padi bit (9) 
unal , 

qrp bit (18), 

pad2 bit (3), 

command bit (6) , 

erct fixed bin (8) 

unal , 

se1ect_data, 

( 

3 limit bit (12), 

3 mbz bit (3), 

3 sector bit (21) 

) unaligned, 

connect_tlme fixed bin 452). 

connects fixed bin. 



pointer to queue entry */ 

pointer to channel information table */ 

queue entry ♦/ 

index to next queue entry */ 

non-zero foi* write operation ♦/ 

non-zero for single sector operation */ 

non-zero if quentry is for disk ready test ♦/ 

non-zero If retry has been performed on broken device */ 

non-zero if queue entry in use ♦/ 

disk cylinder number */ 

pdi of device */ 

memory address for data transfer- */ 

disk device code */ 

disk sector address */ 

number of sectors for sector I/O ♦/ 
low-order microsecond clock at queue */ 
time entry was queued */ 

channel Information table */ 
lo_manager channel Index */ 
lol channel table Index */ 
pointer to hardware status word ♦/ 
channel name */ 



non-zero If 
non-zero If 
non-zero If 
priority of 
non-zero If 
non-zero If 
non-zero If 
saved from status */ 



channel being used ♦/ 
channel active ♦/ 
RSR in progress */ 
current request ♦/ 
channel usurped by 101 */ 
channel Inoperative ♦/ 
channel broken */ 



/* rel ptr to queue entry */ 

/• peripheral command */ 

/* error retry count */ 

/* data passed to lOM on select */ 

/* limit on number of sectors */ 



/* sector address */ 

/* time of last connect ♦/ 

/* count of connects performed */ 



Include ♦, hard. source 
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2 detalledstatus 

2 rstdcw bit (36) 

2 scdcw bit (36), 

2 sddcw bit (36), 

2 dcdcw bit (36), 

2 dddcw bit (36), 

2 dscdcw bit (36) 

2 dsddcw bit 

2 rssdcw bit 

2 status bit 



(O: 17) bit (8) una! 



(36). 
(36). 
(36) a1 igned; 



%page; 
del « 



del 



qiit a1 igned based, 

2 (head, tall) bit (18) unal ; 



dp ptr, 
pvtdip ptr; 



(8), 
(I). 



18). 



del 1 devtab based (dp) aligned. 
( 

2 pvtx fixed bin 
2 1 nop bit ( 1 ) . 
2 was_broken bit 
2 broken bit ( t ), 
2 abandoned bit ( I ) . 
2 pad bit (11). 

2 buddy unsigned fixed bin (6), 
2 pdl unsigned fixed bin (6) 
) unal . 

2 queue_count fixed bin (8). 
2 cylinder fixed bin (11). 
2 seek_dlstance fixed bin (35. 
2 read_count fixed bin. 
2 wr1te_count fixed bin, 
2 tlme_lnop fixed bin (52); 



del 1 pvtdl based (pvtdip) aligned. 
( 

2 sx fixed bin (It). 

2 usab1e_sect_per_cyl fixed bin (11). 
2 unused_SGet_per_cy) fixed bTn (11) 
) unal ; 

del 1 dlsk_lock_meters based aligned. 
2 count f ixed bin. 
2 waits fixed bin, 
2 wait time fixed bin (52); 



/♦ detailed status bytes ♦/ 

I* restore command ♦/ 

/* select command •/ 

/♦ select data xfer */ 

/» command to read or write »/ 

/♦ data xfer DCW ♦/ 

/» RSR command */ 

/* RSR data xfer */ 

/* RSS command */ 

/* saved status ♦/ 

/* queue head/taH structure */ 



/* pointer to device Information table */ 
/* pointer to dlm_1nfo In PVT entry */ 

/♦ device Information table */ 

/♦ Index of PVT entry for device •/ 

/♦ device Inoperative */ 

/♦ device previously broken */ 

/* device down ♦/ 

/* device lost and gone forever */ 

/* other device on this spindle or O »/ 

/+ primary device Index */ 

/* count of requests queued for device ♦/ 

/* current cylinder position ♦/ 

/♦ average seek distance */ 

/♦ count of reads */ 

/♦ count of writes */ 

/» time drive became Inoperative */ 

/♦ disk DIM Info, In PVT entry ♦/ 

/* structure index */ 

/• # of usable sectors on disk cylinder */ 

/* It of unused sectors at end of cylinder ♦/ 

/• lock meters for disk DIM */ 

/» total number of attempts */ 

/* number of attempts which required waiting */ 

/* total time sipent waiting ♦/ 



del ( 

RST_LISTX Init (1). 

SC_LISTX init (2). 

DSC_LISTX init (6), 

RSS_LISTX Init (8) 

) fixed bin (12) static options 



/* End of include file dskdcl . Incl .p 



(constant ) ; 
i »/ 



/• I istx for reistore ♦/ 

/* 1 Istx for sdlect */ 

/* 1 Istx for r;iR •/ 

/♦ I Istx for R'lS */ 



Include.**, hard. source 
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ect_structure8. tnci .pi 1 



segment in: > 1 dd> t nc 1 ude 

entry modified: 03/10/82 0837.0 



contents modified: 09/30/81 135B.8 



/* 



BEGIN INCLUDE FILE 



ect_8tructures. Inci .pi 1 



/♦ format: styles ♦/ 



del 


ect_ptr 


ptr ; 


del 


ectep 


ptr; 


del 


1 ect header 


a 1 1 gned based 




2 ect areap 


ptr. 




2 ect area size 


fixed bin ( 19 




2 flags. 






3 can_prlorlty 


bit (1) unal. 



3 unused bit (17) unal, 
3 mask call count 

fixed bin ( 17) unal , 
2 count (0:5) fixed bin. 



2 entry_l Ist_ptr8 (4), 



3 firstp ptr, 

3 lastp ptr, 
2 meters, 

3 total_wakeups fixed bin {33), 

3 tota1~wa1t wakeups 

fixed bin (33), 

3 total_cal 1_wakeups 

fixed bin (33), 
2 seed fixed bin (33), 

2 1tte8_tossed fixed bin (33), 
2 fin . (5) fixed bin: 



Jan 1981 */ 



/* points to base of Event Channel Table header */ 
/♦ points to event channel table entry */ 

/* structure of the Event Channel Table header */ 

/* pointer to area In which ect entries are allocated ♦/ 

/* number of words In ect area */ 

/* • "©"b If wait chns have priority - default */ 
/* « "1''b If call Chans have priority */ 



/* number times event call chans masked ♦/ 
/* totals of entries allocated */ 

/* O « number of entries, 1 « number of wait channels ♦/ 
/* 2 " number of call channels */ 
/♦ 3 ■ number of call channel messages */ 
/♦ 4 « number of Itt messages, 5 » number of messaged ♦/ 
/♦ head and tall of lists In ECT */ 
. /♦ 1 " wait channels, 2 •= call channels */ 
/* 3 • cali channel messages, 4 <■ Itt messages */ 
/♦ head of 1 1st */ 
/♦ tall of list */ 

/* total wakeups sent on all channels */ 

,/♦ wakeups sent on wait channels */ 

/* wakeups sent on call channels ♦/ 
/* used to generate uld portion of channel name */ 
/* number Invalid ITT messages received. Ignored */ 
/* pad to 36 words */ 



del 


TOTAL 


del 


WAIT 


del 


CALL 


del 


EV_CALL_MESSAQE 


del 


ITT MESSAGE 


del 


EV_MESSA6E 


del 


1 wait channel 




2 word 0, 




3 unused 1 




3 type 




2 next_chanp 



fixed bin static options (constant) tnit (O): 

fixed bin static options (constant) Init (1); 

fixed bin static options (constant) Init (2); 

fixed bin static options (constant) Init (3); 

/* used to Index count and entry_1 lst_ptrs arrays */ 

fixed bin static options (constant) Init (4): 

fixed bin static options (constant) Init (5); 



aligned based (ectep), 

fixed bin (17) unal . 
fixed bin (17) unal , 
ptr unal , 



/♦ Event wait channel - type ■ WAIT ♦/ 



/* - WAIT ♦/ 

/* pointer to next wait channel */ 



Include *, hard. source 
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del 



del 



del 



prev_chanp ptr unal . 

word_3 , 

3 unuseda bit (1) una! . 

3 lnh«blt_count fixed bin (16) unal, 

3 wakBup_count fixed bin (18) unal unsigned. 

bit (72). 

ptr unal , 

ptr una] . 

(4) fixed bin: 



name 

f 1rst_ev_nisgp 

last_ev_niisop 

unused3 



aligned based (ectep), 



fixed bin (17) unal . 
fixed bin ( 17) unal . 
ptr una) , 
ptr unal , 



1 call _channe I 
2 word_0. 
3 priority 
3 type 
2 next_chanp 
2 prev_chanp 
2 word_3, 

3 call_lnhlb1t bit (1) unal. 
3 lnhlblt_count fixed bin (16) unal, 
3 wakeup_count fixed bin (18) unal unsigned, 
bit (72). 
ptr unal . 
ptr unal , 
ptr unal , 



name 

f lrst_ev_nisgp 

iast_ev_nisgp 

data_ptr 

pr ocedur e_va 1 ue , 

3 procedure_ptr ptr unal, 

3 envlronment_ptr 

ptr unal . 
unused f Ixed bin: 

a I Igned based, 



1 event message 


2 


word O, 




3 priority 




3 type 


2 


next ev_msgp 


2 


message_data 


2 


chanp 


2 


next call msgi 


2 


unused2 


1 itt message 


2 


word 0, 




3 unused 1 




3 type 


2 


next itt msgp 


2 


message_data 


2 


unused2 



/» pointer to previous wait channel ♦/ 



/• number of tltifes message reception has been inhibited »/ 

/* number of wakeups received over this channel */ 

I* event channel name associated with this channel ♦/ 

/♦ pointer to first message In queue ♦/ 

/♦ pointer to last message In queue •/ 

/+ pad to 12 words */ 

/• Event call channel - type = CALL */ 

/♦ indicated priority relative to other call chns ♦/ 

/♦ = CALL ♦/ 

/♦ pointer to next call channel */ 

/♦ pointer to prev call channel ♦/ 

/* » »i"b if call to associated proc in progress ♦/ 

/* number of times message reception has been inhibited ♦/ 

/* number of W2keups received over this channel */ 

/♦ event channel name associated with this channel •/ 

/* pointer to first message in queue */ 

/» pointer to last message in queue ♦/ 

/♦ pointer to eissoclated data base ♦/ 

/♦ procedure to call when message arrives */ 

/♦ pointer to eintry point ♦/ 

/» pointer to citack frame */ 
/• pad to 12 words */ 

/♦ Event message - type = EV_MESSAGE »/ 



fixed bin (17) unal, /* priority of call channel */ 

fixed bin (17) unal. /♦ = EV_MESSAGi; ♦/ ^. ^ , ., 

ptr unal. /* pointer to next message, for this channel *l 

like event message_data aligned, 

"" /♦ event message as returned from lpc_$block ♦/ 

ptr unal /♦ pointer to associated event channel */ 

ptr unal! /* pointer to next event call channel message */ 

(2) fixed bin: /* pad to 12 words ♦/ 



al Igned based. 



/* Itt message - type = ITT_MESSAGE */ 



fixed bin ( 17) unal , 

fixed bin (17) unal. ^ . _„_ „„„*,„ ./ 

ptr unal, /* pointer to next Itt message entry In ECT currently */ 

like event_message_data allgnGd, 

(4) fixed bin: /♦ pad to 12 words ♦/ 



del 1 event_channel_narae 

2 ecte_ptr 

2 ring 

2 unlque_ld 



al Igned based, 
ptr unal , 



fixed bin (3) unal unsigned. 



/* description of name of channel »/ 
/* pointer to channel entry in ECT ♦/ 
/* = null if fast channel */ 
/* ring number of ECT */ 



fixed Din y-i} unai uiisiyiieu, /- 1 iiiM ■■^...K-o. w. ..-. , 

fixed bin (33) unal unsigned: /♦ Identified unique to the process */ 



include.**, hard. source 
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del 



dot 



1 fast_channe1_nan)e altgned based, 
2 Gcte_ptr ptr unal. 



/♦ 



2 ring 

2 mbz 

2 channe1_lndex 

1 evBnt__niie8saga_data 

2 channel _td 
2 message 
2 sender 
2 orfgln, 

3 dev_8lgnal 

3 ring 

END INCLUDE file 



fixed bin (3) unal unsigned, 
bit ( IS) unal , 
fixed bin ( 17) unal ; 



a1 Igned based, 
fixed bin (71), 
fixed bin (71), 
bit (36). 

bit (18) unal, 

fixed bin ( 17) unal ; 

. ect structures. Inci .pi 1 ♦/ 



/♦ description of name of of fast channel */ 

/* » null fast channel */ 

/* "= null full event channel */ 

/* target ring number ♦/ 

/* number of special channel ♦/ 



/♦ template for event message ♦/ 

/♦ event channel name ♦/ 

/* 11 bit message associated with wakeup */ 

/* process If of sender */ 

/* "1"b If device signal ♦/ 
/♦ "0"b If user event ♦/ 
/♦ring of sending process */ 



Include », hard. source 
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event watt list. tncl. pit 



segment In: >1dd> Include 

entry modified: 03/IO/B2 0836.7 



contents modified: 06/07/79 1406.5 



/* BEGIN INCLUDE FILE ... event^wal t_l 1st . Inci .pH »/ 

/♦ lpc_$block wait list structure -- HUBt begin on an even word boundary. 
Written 9-May-79 by M. N. Davldoff. 



♦/ 



declare event_wa1t_1 1st_n_channels 

fixed binary: 
declare event_wa1 t_l l8t_ptr pointer; 



declare 1 event_wa1 t_1 1st 
2 n_channe1s 
2 pad 
2 channel Id 



aligned based (evenl_wal t_l lst_ptr) , 

fixed binary, /♦ number of cinannels In wait list ♦/ 

(event wal t_l 1st_n_channels refer (event_wa1 t_l ist .n_channel8) ) fixed binary (71); 
~ /* event channals to wait on */ 



/* END INCLUDE FILE ... event_wa I t_1 1st . Incl .pH */ 



Include.**, hard. source 
FnnA - Kint to ha reoroduced 
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f aul t_vector. Inci .pi 1 



segment In: 
entry modlf ted: 



> I dd> Include 
03/10/82 0836. 



contents modified: 06/10/B1 1658.7 



/• BEGIN INCLUDE FlLt 
del fvp ptr; 



faul t_vector. Inci .pi 1 



del 1 fv based (fvp) aligned, 
2 Ipalr (O: 31), 

3 scu bit <36). 

3 tra bit (36). 
2 fpatr (O: 31). 

3 scu bit (36), 

3 tra bit (36), 
2 l_tra_ptr (O: 31) ptr. 
2 l_scu_ptr (O: 31) ptr. 
2 f_tra_ptr (0: 31) ptr, 
2 f_scu_ptr (O: 31) ptr; 

/* Fault Types by fault number 



del (FAULT 

fault" 

FAULT 

fault' 

fault' 

fault' 

fault" 

fault 

fault" 

fault" 

fault" 

fault 

fault" 

fault' 

fault 

fault 

fault" 

fault" 

fault 

FAULT 

fault" 
fault" 
fault" 
fault" 
fault" 
fault" 



NO_SDF 
NO_STR 
NO_MME 

■no_f 1 

NO_TRO 

"no_cmo 
'no_drl 

NO_LUF 
NO_CON 

"no_par 

NO I PR 
NO~ONC 
NO SUF 
NOloFL 
NO_OIV 
NO_EXF 
N0_DFO 
NO_OF 1 
■Na_DF2 
■nOJ)F3 

■no_acv 

■no_MME2 
N0_MME3 
N0_MME4 
N0_F2 
NO F3 



Init 
Init 
Init 
Init 
Init 
Init 
Init 
Init 
Init 
Init 
Inlt 
Init 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 
Inlt 



(O). 

(1). 

(2). 

(3). 

(4). 

(5). 

(6). 

(7). 

(8). 

(9). 

(10). 

(11). 

(12). 

(13). 

(14). 

(15). 

(16). 

(17). 

(IB). 

(19). 

(20). 

(21). 

(22). 

(23). 

(24). 

(25). 



last modified February 1981 */ 

/* pointer to the fault and Interrupt vectors */ 

/«► fault and Interrupt vectors ♦/ 

/* Interrupt pairs */ 

/» SCU Instruction */ 

/• TRA Instruction «/ 

/* fault, pairs */ 

/* SCU Instruction *"/ 

/* TRA instruction ♦/ 

/« ITS pair for Interrupt TRA Instruction ♦/ 

/* ITS pair for Interrupt SCU Instruction */ 

/* ITS pairs for fault TRA Instruction ♦/ 

/* ITS pairs for fault SCU Instruction ♦/ 



/♦ Shutdown 

/* Store 

/* Master Mode Entry 1 

/* Fault Tag 1 

/* Timer Runout 

/ * Command 

/♦ Derail 

/* Lockup 

/♦ Connect 

/* Parity 

/* Illegal Procedure 

/* Operation Not Complete 

/* Startup 

/» Overflow 

/* Divide Check 

/* Execute 

/» Directed Fault O 

/* Directed Fault 1 

/♦ Directed Fault 2 

/♦ Directed Fault 3 



(Segment Fault) 
(Page Fault) 



FAULT_NCr.TRB Inlt (31) 



/* Access Violation 

/♦ Master Mode Entry 2 

/♦ Master Mode Entry 3 

/* Master Mode Entry 4 

/* Fault Tag 2 (Linkage Fault) 

/* Fault Tag 3 

/* Fault Numbers 26-30 unasslgned 

/♦ Trouble 



♦/. 

*/ 

♦/ 
*/ 
*/ 
♦/ 
*/ 
♦/ 
*/ 
*/ 
♦/ 
♦/ 
*/ 
*/ 
*/ 
♦/ 
*/ 
♦/ 
*/ 
*/ 
*/ 
*/ 
*/ 
•/ 
*/ 
*/ 
*/ 



) fixed bin (17) Int static options (constant); 



Include ', hard. source 
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/♦ END INCLUDE FILE ... f aul tvector . Incl .pll */ 



tncliide.**. hard. source f aul t_vector . Inci .pi 1 
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fgbx. (ncl .p) 1 



segment tn: 
entry modi fled: 



> 1 dd> 1 nc 1 ude 
09/17/82 1333.3 



contents modified: 09/ 17/82 1333.2 



/♦ BEGIN INCLUDE FILE ... fgbx. Incl .pi 1 ♦/ 
/* last modified 5/3/77 by Noel I. Morris 



♦/ 



/* Modified B/79 by R.J.C. Kissel to add FNP blast message. */ 
/♦ Modified 7/82 BIM for recognizable sentinel field »/ 

/* The contents of this segment are data shared by Multlcs and BOS. 

This segment occupies the 2nd, 3rd, 4th. and 5th 16-word blocks of the BOS toehold. 



♦/ 



del flagbox$ ext; 
del fgbxp ptr; 

del 1 fgbx based (fgbxp) aligned, 
2 flags (36) bit (1) unal. 
2 s1t_segno bit (18), 
2 padi fixed bin, 
2 rtb. 
(3 ssenb bit ( t). 

3 call_bos bit (1). 

3 shut bit (1), 

3 mess bit (1), 

3 alert bit (1). 

3 pad bit (2S), 

3 bos_entry fixed bin (5)) unal. 



2 sentinel char (32) aligned, 
2 sst sdw bit (72). 
2 hc_dbr bit (72), 
2 message char (64), 
2 fnp_blast char (128): 



/* communications switches */ 
/* segment # of the SLT ♦/ 



/* 
/* 
/* 
/* 
/* 
/* 

/* 



return to BOS Info ♦/ 
"l"b if storage system enabled */ 
"1"b If BOS. called by operator ♦/ 
"1"b If BOS called after shutdown ♦/ 
"1"b If message has been provided ♦/ 
"1"b If audible alarm to be sounded */ 



type of entry Into BOS 

-> XED 10002 (BOS entry) 

1 "> XED 10004 (Multlcs entry) 

2 ■> XED 10000 (manual entry) ♦/ 
/* set by BOS (for now) */ 

/* set by lnlt_8*t ♦/ 

/* set by start_cpu. Idle DBR ♦/ 

/« message for return to BOS */ 

/* message for FNP use when Multlcs Is down. ♦/ 



declare FLA6B0X SENTINEL char (32) Init ("Flagbox ft Toehold Valid") Int static options (constant); 



/* END INCLUDE FILE 



fgbx. Incl .pi 1 */ 



Include *, hard. source 
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fs dev types )nc1. pit segment In: >1dd>lnc1uda contents modified: 02/09/81 1416.2 

- - entry modified: 03/10/82 0836.8 



/♦ Begin Include file f s_dev_typss. IncI .pi 1 */ 

/* Modified 5/19/76 by N. I. Morris */ 

/* Modified 12/27/78 by Michael R. 'dordan to correct MSS0500 information *t 

/* Modified 4/79 by R.U.C. Kissel to add msuOSOl Information. */ 

del (maxdevt Init (7). /* nia>«»™um legf.l devt ♦/ 

bulkdevt Inlt (1). /♦ bulk store devt •/ 

msuOSOOdevt Inlt (2), /* MSU0500 device type */ 

TOSu0451devt Init (3). /* MSU0451 device type */ 

msu0450devt Inlt (3). /* MSU0450 dev Ice type */ 

msu0400devt Inlt (4). /♦ MSU0400 device type */ 

dsul91devt Inlt (4). /• DSU191 device type */ 

dsuieodevt Inlt (S). /• 0SU190 device type ./ 

dsulBldevt inlt (6). /' DSUlSt device type ♦/ 

rasuOBOldevt Inlt (7) /♦ MSU0501 device type ♦/ 
) fixed bin (4) static options (constant); 

del MODEL (10) fixed bin static options (constant) Inlt /♦ Known device model numbers */ 
(O, 500, 451, 450. 400, 402, 191, 190. 181. 501); 

del MODELX (10) fixed bin static options (constant) inlt /» translation from model number to device type */ 
(1. 2. 3. 3. 4. 4. 4. 5, 6, 7); 

del MODELN (7) fixed bin Static options (constant) Inlt /* translation from device type to model number »/ 
(O, 500, 451, 400. 190, 181, 501); 

del devlce_names (7) char (4) aligned static options (constant) inlt ( /♦ device names Indexed by device type ♦/ 
"bulk", "dSOO", "d451". "d400". "d190", "dlBl". "d501"): 

del med1a_removable (7) bit (1) static options (constant) Inlt /» ON •> demountable pack on device */ 
("0"b, "0"b. "l"b. "1"b, "1"b. "1"b, "0"b); 

del shared_splndle (7) bit (1) static options (constant) Inlt /» ON '> 2 devices per spindle */ 
("0"b. "l"b. "0"b. "0"b, "0"b, "0"b. "1"b): 

del rec_per_dev (7) fixed bin static options (constant) Init /* table of # of records on each device »/ 
(O, 38258, 38258, 19270, 14760, 4444, 6720O) ; 

del cyl_per_dev (7) fixed bin static options (constant) init /♦ table of # of cylinders on each device ♦/ 
(O, 814. 814. 410, 410. 202, 840); 

del rec_per_cyl (7) fixed bin static options (constant) Inlt /* table of H of records per cylinder on each device ♦/ 
(O, 47. 47. 47, 36. 22. 80): 

del sect_per_cy1 (7) fixed bin static options (constant) Init /* table of H of sectors per cylinder on each device */ 
(O. 760; 760. 760. 589, 360, 1280); 

del sect_per_rec (7) fixed tain static options (constant) inlt /♦ table of # of sectors per record on each device ♦/ 
(O, 16, 16. 16, 16. 16, 16); 



include.**, hard. source ~ f s_dev_types. Incl.pll ''^9^ ^^ 
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del track8_per_cyl (7) fixed bin static options (constant) Init /♦ table of # of tracks per cylinder on each device ♦/ 
(0, 19. 19. 19. 19. 20. 20): 

del sect_per track (7) fixed bin static options (constant) Init /* table of * of sectors per track on each device */ 
(O. 40. 40, 40. 31, 18, 64); 

del words_per_8ect (7) fixed bin static options (constant) Init /♦ table of # of words per sector on each device */ 
(O. 64. 64. 64. 64. 64. 64); 

del f lrst_rec_num (7) fixed bin static options (constant) Init /* table of # of first record on each device ♦/ 
(O. 0, O. 0, O, 0. 0); 

del la8t_rec_nuni (7) fixed bin (IB) static options (constant) init /* table of # of last record on each device ♦/ 
(O. 38257, 38116. 19128. 14651. 4399. 67199): 

del f ir8t_8ect_num (7) fixed bin (24) static options (constant) Init /♦ table of # of first sector for each device ♦/ 
(O. 0. 0. O. O. O. O); 

del last sect num (7) fixed bin (24) static options (constant) init /♦ table of # last sector number for each device ♦/ 
(0. 6786397 616359. 309319, 239722, 71999. 1075199): 

del first alt_8ect nuw (7) fixed bin (24) static options (constant) Init /♦ table of // of first sector of alt partition */ 
(0. 638400. 616360. 309320. 239723, 72000. 1075200): 

del last alt sect num (7) fixed bin (24) static options (constant) Init /* table of # of last sector of alt partition ♦/ 
(0. 639919, 618639, 311599, 241489, 72719, 1077759); 

del last_phys1cal_Sect_num (7) fixed bin (24) static options (constant) init /* table of # of last sector on device (Includes TRD c 
ylinders) */ 

(O. 639919, 619399, 312359, 242249. 72359, 1077759); 

del dev_t1ine (7) float bin (27) static options (constant) init /♦ table of average access times for (jach device ♦/ 
(384eO, 3318760, 33187eO, 34722eO, 46935eO, 52631eO. 33187gO): 

/* End of include file f s_dev_types. Incl .pi 1 */ 
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fs_types. incl .pi 1 segment in; >ldd>lnclude contents modified: 05/18/77 0B19.5 

entry modtfted; 03/10/82 083C.6 

/♦ BEGIN INCLUDE FILE ... f s_types. incl .pH ♦/ 

del ACCESS_NAME_TVPE bit (18) static options (constant) Init ( "bOOOOl "b3) ; 

del ACLE_TYPE bit (18) static options (constant) init ( "000002"b3) ; 

del OIR_HEADER_TYPE bit (18) static options (constant) Init ( "000003"b3) ; 

del DIRTYPE bit (IB) static options (constant) Init ( "OOOO04"b3 ) ; 

del LINK_TYPE bit (18) static options (constant) init ( "O000O5"b3) ; 

del NAME_TYPE bit (18) static options (constant) init ( "000006 "!b3) ; 

del SEG_TVPE bit (18) static options (constant) init ( "000007 "b3 ) ; 

del HASH_TABLE_TYPE bit (18) static options (constant) init ( "OOOOI3"b3) ; 

del access_nanie_type fixed bin static options (constant) init (I): 

del acle_type fixed bin static options (constant) Init (2); 

del dlr_header_type fixed bin static options (constant) init (3); - 

del dlr_type fixed bin static options (constant) init (4); 

del link_type fixed bin static options (constant) init (5); 

del name_type fixed bin static options (constant) init (6); 

del seg_type fixed bin static options (constant) init (7); 

del hash_tab)e_type fixed bin static options (constant) init (11); 

/* END INCLUDE FILE ... f s_types. incl .pi 1 */ 



inC: 3.**, hard. source f s_types. Inc' '1 ^ge 38 
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fs vol label inci pi 1 ' segment ln:Mdd>1nclude contents modified: 05/20/82 1037.5 

fs_vol_label.«nci.pii entry modified: 05/20/82 1047.6 



/* BEGIN INCLUDE FILE ... f s_vo1_1abe1 . Inci .p11 .. last modified January 1982 for hew volume map format ♦/ 

/♦ This Is the label at fixed location of each physical volums. Length 1 page */ 

del labelp ptr; 

del 1 label based (labelp) aligned. 

/♦ First comes data not used by Multlcs.. for compatibility with GCOS */ 

2 gcos (5*64) fixed bin, 
/* Now we have the Multlcs label */ 

2 Multlcs char (32) Inlt ("Multlcs Storage System Volume-). /* Identifier ♦/ 

1 ^-.Tm hi» f\R\ /♦ Unique ID of this pack ♦/ 

I P^^ l\\ \fA' /* unique ID of Its logical vol •/ ^ . 

1 * „,L hT;'r-jR^ /* unique ID of the pack containing the root, everybody must agree. ♦/ 
\ ^im^^eitstlrei'nied bin (71). A t1m2 Imported to ^V^tem »/ 

r, „w~4n i« fivnri bin /* * P^ya Volumes In logical ♦/ 

2 CS? izi fixed bin • /* to*"' «'^« «' ^°'""'«- '" '■«'=°'''^'» *' , 

1 w?r.? I^L f^ved b?n /♦ number of recs In fixed area + vtoc */ 

2 v*o«=-«<^® 'i'*^^,'';";, • /♦ used to be multiple class ./ 

1 prlvatrblJMruna?;- /* TRUE If was reglsteFed as private */ 

2 mlx^accesiMasJ bu'(72). /♦ Maximum, access class for stuff on volume */ 
2 :tn-acce"-c!«s b!t ill\\ I* Minimum access class for stuff on volume ,/ 
2 password bit (72). /* "°* V^* "=««* *' 

2 padi (16) fixed bin. , ^. ^ ^ ^i 

2 time mounted fixed bin (71). /* * •«« •"°""*f'^ *!, h ./ 

2 t1me>ap_updated fixed bin (71). /* time vraap known good */ 

/♦ The next two words overlay time unmounted on pre-MRIO systems. This 
forces a salvage If an MR10 pack Is mounted on an earlier system. 

*^ 2 volmap.verslon fixed bin. /* version of volume map (currently 1) */ 
2 pad6 fixed bin, 

2 time salvaged fixed bin (71). /* time "'^^^^^ *^,. . ., 

2 tlmd'of boot fixed bin (71). /* t me of '««* ^°°*'°=f„*{ , 

2 tIme-unSounted fixed bin (71). /* time 'i""'°""*«^_Sl^'^ly *' 

2 last'pvtx fixed bin. /* P>'tx *" that PDMAP */ 

\ err'hiif sIzr?ixeS'b1n /* ='" ^' P^'^'* ^^^^^ '^^«*°''V */ 

2 Um5^:st!dmp (3) flxIS'bln (71). /* time last completed dump pass started */ 
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2 time 1 as tre loaded f l^ed bin (71), 
2 pad2' (40) fixed bin, 
2 root, 

3 here bit (1). 

3 root_vtocx fixed bin (35), 

3 shutdown_state fixed bin, 

3 pad? bit (1) a1 Igned, 

3 d1sk_table_vtocx fixed bin, 

3 disktableuid bit (36) aligned. 

3 esd_state f1xed.bin, 
2 volmap_rocord fixed bin, 
2 s 1ze_of_voln)ap fixed bin, 
2 vtoc_map_record fixed bin, 
2 s1ze_of_vtoc_map fixed bin, 
2 volmap_unlt_s1ze fixed bin, 
2 vtoc_orlg1n_record fixed bin, 
2 dumper _b 1 t_map_record fixed bin, 
2 vol_trouble_count fixed bin, 
2 pad3 (52) fixed bin, 
2 nparts fixed bin, 
2 parts (47), 

3 part char (4), 

3 free fixed bin, 

3 nrec f Ixed tain, 

3 pad5 fixed bin, 
2 pad4 (5*64) fixed bin: 



/♦ what it says ♦/ 



/* TRUE If the root is on this pack ♦/ 

/♦ VTOC Index of root, If It is liere */ 

/* Status of tilerarchy */ 

/* VTOC Index of disk table on RPV */ 

/* UID of disk table ♦/ 

/* State of esd if 

/♦ Begin record of volume map ♦/ 

/♦ Number of records In volume map •/ 

/♦ Begin record of VTOC map */ 

/♦ Number of records In VTOC map ♦/ 

/♦ Number of words per volume map section */ 

/♦ Begin record of VTOC »/ 

/» Begin record of dumper bit -map */ 

/* Count of Inconsistencies found since salvage */ 



I* Number of special partitions on pack */ 

•/ 
*/ 



/* Name of partition 
/• First record ♦/ 
/* Number of records 



del Mul t lcs._ID_Str Ing char (32) Init ("Multlcs Storage System Volume") static; 
/* END INCLUDE FILE f s_vol_label . Inc) .pH */ 
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he lock. IncI .pi 1 



segment tn: >'ldd!> tnclude 

entry modified: 04/14/82 1337.7 



contents modified: 04/14/B2 1336.1 



/* Begin Include file he lock. IncI .pi 1 BIM 2/82 */ 

/♦ Lock format suitable for use with lock$1ock_f est . unlock_fast */ 

/♦ format: 8tyle3 */ 



dec I are 
declare 



1ock_ptr 
1 lock 
2 pfd 
2 event 
2 flags 

3 notlfy_sw 
3 pad . 



pointer: 

aligned based (lock_ptr). 

bit (36) aligned, 

bit (36) aligned. 

al igned, 

bit (1) unaligned, 

bit (35) unal Igned; 



/* holder of lock */ 

/♦ event associated with lock */ 



/♦ certain locks use this pad, like dirs ♦/ 



/♦ End Include file hc_1ock. IncI .pi 1 */ 



Include ♦. hard. source 
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i t tentry . Inci .pi 1 



segment In: 

entry modified: 



> 1 dd> i nc 1 ude 
03/10/82 OB37.0 



contents modified: 08/06/81 1825.8 



/* 



BEGIN INCLUDE FILE 



/* format: style3 */ 
del itte_ptr 

del 



1 itt_entry 

2 next_ltt_relp 
2 pad 
2 sender 


2 

2 
2 


origin, 

3 dev_signal 

3 ring 

target_id 

channel id 


2 


message 



/* 



END INCLUDE FILE 



ittentry. incI .pi t 



ptr ; 

aligned based (ltte_ptr). 
bit' ( 18) unal igned, 
bit (18) unal Igned. 
bit (36). 

bit ( 18) unal igned, 
fixed bin (17) unaligned, 
bit (36). 
fixed bin (71). 
fixed bin (71); 

1 tt_entry . incl .pi 1 ♦/ 



Feb 1981 ♦/ ' 



/♦ painter to entry in ITT ♦/ 

/♦ declaration of single entry In the ITT ♦/ 
/* thread of relative pointers ♦/ 

/♦. id of sending process ♦/ 

/* origin of event message */ 

/♦ O = user-event. 1 = device-signal ♦/ 

/♦ if user-event, sender's validation ring */ 

/* target process' id ♦/ 

/* tairget process' event channel */ 

/♦ event message */ 
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kst. Inci .pi 1 



segment In: >1dd>lnc1ucle 

entry modtfled: 03/14/B3 1655.6 



contents modified: 03/14/83 1654.3 



/* BEQIN INCLUDE FJILE 

del pdsSkstp ext ptr, 
(kstp, kstep) ptr; 



kst. Inc) .pi 1 



last modified March 1976 by R. Bratt */ 



del 1 kst aligned based (kstp). 
2 lowseg fixed bin (17), 
2 highseg fixed bin (17), 
2 hlghe3t_u8ed_8egno fixed bin (17). 
2 Ivs fixed bin (8), 
2 tlme_of_boot1oad fixed bin (71), 
2 garbage_conectlon8 fixed bin (17) unaligned, 
2 entrles_conected fixed bin (17) unaligned. 
2 free_ll8t bit (18) unaligned, 
2 prel Inked ring (7) bit (1) unaligned, 
2 template bit (1) unaligned. 
2 allow 256K connect bit (1) unaligned. 
2 unused 2 bit (9) unaligned. 

2 uld_hash bucket (O : 127) bit (IB) unaligned, 
2 kst entry (O refer (kst . lowseg) :0 refer (kst .highseg) 
2 1v Tl:256) bit (36). 
2 end of kst bit (36): 



del 



kste based (kstep) aligned, 

fp bit (18) unaligned, 

segno fixed bin (17) unaligned. 

U8age_count (0:7) fixed bin (8) unaligned, 

entryp ptr unaligned, 

uld bit (36) aligned, 

access_lnformatlon unaligned, 

3 dtbm bit (36). 

3 extended_access bit (33). 

3 access bit (3), 

3 ex rb (3) bit (3). 

hdr bit (3) unaligned. 

flags unal Igned, 

3 dlrsw bit (1). 

allow write bit (1). 

priv Tnlt bit (1), 

tms bit (1), 

tus bit (1). 

tpd bit (1). 

audit bit (1), 

explicit deact_ok bit 

pad bit T3). 



(1). 
2 inf count fixed bin (12) unaligned; 



/♦ KST header declaration ♦/ 

/♦ lowest segment number described by kst «/ 

/* highest segment number described by kst */ 

/* highest segment number yet used ♦/ 

/♦ number of private LVs this process Is connected to */ 

/♦ bootload time during prel Inking */ 

/* KST garbage collections */ 

/* KST entries recovered by garbage collection ♦/ 

/♦ relative pointer to first free kste */ 

/♦ rings prel Inked In process */ 

/* this Is a template kst If set */ 

/* can use 256K segments ♦/ 

/* hash buckets */ 

) aligned like kste. /* kst entries ♦/ 
/* private logical volume connection list */ 

/♦ KST entry declaration */ 

/* forward rel pointer ♦/ 

/* segment number of this kste */ 

/* outstanding Inltlates/ring ♦/ 

/♦ branch pointer */ 

/♦ unique Idemtlfler */ 

/* date time branch modified */ 

/* extended eiccess from the branch ♦/ 

/♦ rew */ 

/♦ ring brackets from branch */ 

/♦ highest dcitoctable ring */ 

/* directory switch */ 

/* set If Initiated with write permission */ 

/♦ privileged Initiation */ 

/♦ transparent modification switch ♦/ 

/• transparent usage switch ♦/ 

/» transparent paging device switch ♦/ 

/* audit 8wli:ch */ 

/* set If I «m wining to have a user force deactivate */ 

/* JjF dlrsw jthen Inferior count else Iv Index ♦/ 



I* END INCLUDE FILE 



kst. IncI .pi 1 



♦/ 
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lock_array . Inc) .pi 1 segment In: >ldd> include contents modified: 04/14/82 1336.2 

entry modified: 04/14/82 1337.7 

/* BEGIN INCtUDE FILE ... lock_array . inci .pi 1 */ 
/* modified BIM 2/82 to clean up */ 
/♦ format: styles ♦/ 

del 1 pds$lock_array (0:19) external aligned like pds_entry; 

del 1 pds_entry based, 

2 lock.ptr pointer, 

2 event bit (36) aligned, 

2 flags a I igned, 

3 dir_lock bit (1) unaligned, /♦ This is a dir read lock ♦/ 

3 one_word bit (1) unaligned, /* lockSwait */ 

3 pad bit (34) unaligned, /♦ else lock$lock_f ast */ 

2 caller_ptr painter; 

/♦ END INCLUDE FILE ... 1ock_array . Incl .pi 1 */ 
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Ivt. incl .pi 1 



segment In: 
entry modtfled: 



> I dd> t nc 1 ude 
03/10/82 0836.6 



contents modified: 11/22/76 1025.1 



*/ 



/* BEQIN INCLUDE FILE Wt.lncl.pll -- Written Jan. 1976 by R. Bratt 

This Include file defines the format of the hardcore Logical Volume Table (LVT). 
*/ 

del lvt$ ext; 
del Ivtp ptr; 
del Ivtep ptrj 



del 1 Ivt aligned based (Ivtp), 
2 raax_lvtex fixed bin (17). 
2 hlBh_water_1vtex fixed bin (17), 
2 free_lvtep ptr. 
2 padi (4) bit (36). 
2 ht (0:63) ptr unal. 
2 Ivtes (1:1 refer ( ivt .max_lvtex)) like ivte; 

del 1 Ivte aligned based (Ivtep), 
2 Ivtep ptr unaligned. 
2 pvtex fixed bin (17). 
2 Ivid bit (36). 
2 access class aligned, 

3 min bit (72). 

3 max bit (72), 
2 flags unaligned, 

3 publ Ic bit (1), 

3 rBad_on1y bit (1). 

3 pad bit (16). 

3 cvcle_pvtx fixed bin (17); 

/♦ END INCLUDE FILE lvt.lnel.p11 



/* maximum number of LVs descrlbable ♦/ 
/* highest LVT Index assigned ♦/ 
/» pointer to first free ivte */ 

/* Ivid hash table ♦/ 
/* LVT entries */ 

/* logical volume table entry ♦/ 

/♦ Ivid hash thread */ 

/♦ thread of mounted PVs */ 

/* logical volume Id */ 

I* access Isolation mechanism stuff */ 

/* minimum access class allowed on LV */ 

/♦ maximum access class allowed on volume •/ 

/♦ flags ♦/ 

/* •> anyor« can connect to this LV ♦/ 

/* "> no writes on this LV */ 

/♦ pvtx for next perprocess seg */ 

*/ 
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mc.inc1.pM segment in: > JddXncJude contents mod If ted: 09/OB/81 1426.4 

entry modified; 03/10/82 0837. O 



/* 
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*/ 

/♦ BEGIN INCLUDE FILE mc.lncl.pM Created Dec 72 for 6180 

/* Mod* f ted 06/07/76 by Qreenberg for mc.reslgnal ♦/ 

/♦ Modtfled 07/07/76 by Morris for fault register data */ 

/» Modified 08/28/80 by d. A. Bush for the DPS8/70M CVPU ♦/ 



WSS. ♦/ 



/♦ words 0-15 pointer registers ♦/ 
del mcp ptr; 



del 



1 


mc based (mcp) aligned. 


2 


prs (0:7) ptr. 


(a 


regs. 




3 X (0:7) bit (18). 




3 a bit (36), 




3 q bit (36), 




3 e bit (8). 




3 padi bit (28). 




3 t bit (27), 




3 pad3 bit (6). 




3 ralr bit (3). 



/* POINTER REGISTERS */ 

/♦ registers */ 

/♦ Index roglsters */ 

/* accumuliitor */ 

/♦ q-regl8l:er */ 

/♦ exponeni: */ 

/* timer register •/ 

/* ring aliirm register */ 



S scu (0:7) bit (36). 

2 mask bit (72). 

2 lps_temp bit (36), 

2 errcode fixed bin (35). 

2 flm_temp, 

3 unlque_lndsx bit (18) unal , 

3 reslgnal bit (1) unal, 

3 fcode bit (17) unal. 
2 fault reg bit (36). 
2 pad2 bit (I), 

2 cpu_type fixed bin (2) unsigned, 
2 ext fault reg bit (15), 
2 fauTt_t1roe bit (B4), 

2 els Info (0;7) bit (36)) unaligned; 



/* mem conitroller mask at time of fault */ 
/* Temporary storage for IPS Info */ 
/* fault handler's error code */ 

/♦ unique Index for restarting faults */ 

/♦ recompu^te signal name with fcode below */ 

/* fault code used as Index to FIM table and SCT */ 

/♦ fault roglster ♦/ 

/♦ L68 - O, DP58/70M « 1 ♦/ 

/♦ extended fault reg for DPS8/70M CPU */ 

/♦ time of fault */ 



del (apx fixed bin Init (0), 

abx fixed bin Init (1). 

bpx fixed bin Init (2). 

bbx fixed bin Init (3). 

Ipx fixed bin Init (4). 

Ibx fixed bin Init (5), 

spx fixed bin Init (6), 

sbx fixed bin Init (7)) 



Internal static; 
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del scup ptr; 

dc! t scu based (scup) aligned. 



/♦ SCU DATA */ 



/* WORD (O) 

(2 ppr. 

3 prr bit (3). 
3 psr bit < 15). 
3 p bit (1). 

2 apu, 

3 xsf bit (1). 
3 sdwro bit (I). 
3 sdon bit (1), 
3 ptwm bit (1), 
3 pt_on bit ( 1 ) , 
3 p I _ap bit ( 1 ) . 
3 dsptw bit ( O. 
3 sdwnp bit ( 4 ) , 
3 sdwp bit ( t > . 
3 ptw bit ( t ). 
3 ptw2 bit ( «). 
3 fap bit ( t >, 
3 fanp bit ( t), 
3 fabs bit (1). 

2 fault cntr bit (3), 



*/ 



/♦ PROCEDURE POINTER REGISTER ♦/ 

/♦ procedure ring register ♦/ 

/♦ procedure segment register ♦/ 

/♦ procedure privileged bit ♦/ 

/♦ APPENDING UNIT STATUS ♦/ 

/♦ ext seg flag - IT modification */ 

/♦ match In SOW Ass. Mem. ♦/ 

/» SOW Ass. Mem. ON */ 

/♦ match In PTW Ass. Mem. ♦/ 

/* PTW Ass. Mem. ON */ 

/♦ Instr Fetch or Append cycle */ 

/* Fetch of DSPTW */ 

/* Fetch of SOW non paged */ 

/* Fetch of SDW paged */ 

/♦ Fetch of PTW ♦/ 

/♦ Fetch of pre-paged PTW »/ 

/♦ Fetch of final address paged ♦/ 

/♦ Fetch of final address non-paged */ 

/♦ Fetch of final address absolute ♦/ 

/+ number of retrys of EIS Instructions */ 



/♦ 



WORD ( 1 ) 



♦/ 



fd, 

3 iro bit ( 
oeb bit ( 
e_off bit 
orb bit ( 
r_off bit 
owb bit ( 
woff bit 
no_ga b i t 
ocb bit ( 
oca 11 bit 
boc bit ( 
inret bit 
crt bit ( 
rair bit 
am_er b I t 
oosb bit 
paru bit 
pari bit 
one 1 bit 



1). 
1). 

(1). 
1). 

(1). 
1>. 

(1). 

(1). 
1). 

(1). 
1). 

(1). 
1). 
(1). 

(1). 
(1). 
(1). 
(1). 

(1). 



/♦ FAULT DATA ♦/ 

/♦ Illegal ring order ♦/ 

/* out of execute bracl<et */ 

/* no execute ♦/ 

/* out of read bracket */ 

/♦no read ♦/ 

/* out of write bracket */ 

/♦no write ♦/ 

/♦ not a gate ♦/ 

/♦ out of call bracket ♦/ 

/♦ outward cal 1 */ 

/+ bad outward call ♦/ 

/♦ Inward return ♦/ 

/♦ cross ring transfer ♦/ 

/♦ ring alarm register ♦/ 

/* associative memory fault * 

/♦ out of segment bounds ♦/ 

/♦ processor parity upper ♦/ 

/+ processor parity lower ♦/ 

/♦ op not complete type 1 */ 
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3 onc_2 bit- (1). 

2 port Stat, 
3 taT bit (4), 
3 <ac bit (3). 
3 con_chan bit (3), 

2 fl_nuni bit (5). 
2 f l_flaB bit (1). 



/* op not complete type 2 ♦/ 

/* PORT STATUS */ 
/* Illegal action lines ♦/ 
/* Illegal action channel */ 
/* connect channel */ 

/* (fault/ Interrupt) number ♦/ 

/♦ I "> fault. O => Interrupt */ 



/* WORD (2) 

2 tpr. 

3 trr bit (3), 
3 tar bit (15). 

2 pad2 bit (9). 

2 cpu_no bit <3). 

2 delta bit (6). 



•/ 



/♦ TEMPORARY POINTER REGISTER */ 
/* temporary ring register ♦/ 
/* temporary segment register */ 



/♦ CPU number */ 

/♦ tally modification DELTA */ 



/* WORD (3) 

2 word3 bit (18). 

2 t8r_8tat, 
3 tsna, 

4 prn bit (3). 

4 prv bit (1). 
3 tsnb, 

4 prn bit (3). 

4 prv bit (1). 
3 tsnc, 

4 prn bit (3). 

4 prv bit (1). 

2 tpr_tbr bit (6). 



*/ 



/» TSR STATUS for l,2.&3 word Instructions */ 
/* Word 1 Bteitus ♦/ 

PFI number */ 

pp val Id bit ♦/ 

status */ 

PF! number ♦/ 

Pf! val Id bit */ 

Status */ 

PK number ♦/ 

PH val Id bit */ 



/* Word 1 
/* Word 1 
/* Word 
/♦ Word 
/* Word 
/* Word 
/♦ Word 
/* Word 



/* TPR.TBR i-leld ♦/ 



/• WORD (4) 

2 lie bit (18), 

2 Ir. 

3 zero bit (1). 
3 neg bit (1). 
3 carry bit ( 1 ), 
3 ovfl bit (1). 
3 eovf bit (1), 
3 eufl bit (1). 
3 of irn bit (1), 
3 tro bit (1). 



♦/ 



/* INSTRUCTION COUNTER */ 

/* INDICATOR REQISTERS */ 
/* zero Indicator ♦/ 
/* negative Indicator +/ 
/♦ carryry Indicator ♦/ 
/* overflow Indicator ♦/ 
/* eponent overflow ♦/ 
/* exponent underflow */ 
/* overflow mask ♦/ 
/♦ tally runout */ 
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3 par bit ( 1 ), 
3 parm bt t ( 1 ) , 
3 bm b 4 1 ( t ) , 
3 tru bit ( t ). 
3 mlf bit ( O. 
3 abs b < t ( t ) . 
3 pad b<t (4), 



/» parity error ♦/ 

/♦ parity niasl< ♦/ 

/* 'bar mode */ 

/* truncation mode */ 

/♦ muiti-word instruction mode 

/* absolute mode */ 



/* WORD (5) 

2 ca bit ( 18), 



*/ 



cu, 
3 rf 



bit (1). 
rpt bit < 1), 
rd bit ( 1 ) , 
rl bit (1), 
pot bit (1) 

bit 

bit 

bit 

bit 

bit 

bit 



pon 
xde 
xdo 
poa 
rf i 
its 



if bit 



(1) 
(1) 
(1) 
(«) 
(1) 
(1) 
(1), 



2 cpu_tag bit (6)) unaligned. 



/+ COMPUTED ADDRESS ♦/ 

/♦ CONTROL UNIT STATUS ♦/ 

/+ on first cycle of repeat instr ♦/ 

/* repeat instruction ♦/ 

/* repeat double instruction */ 

/» repeat link Instruciton ♦/ 

/♦ IT modification «/ 

/♦ return type instruction */ 

/* XDE from Even location */ 

/♦ XDE from Odd location */ 

/* operation preparation ♦/ 

/* tells CPU to refetch instruction */ 

/* ITS modification ♦/ 

/» fault occured during Instruction fetch */ 

(* computed tag field <■/ 



/♦ WORDS (6,7) 

2 even_inst bit (36), 
2 odd_1nst bit (36); 



♦/ 



/♦ even Instruction of faulting pair */ 
/» odd Instruction of faulting pair ♦/ 



ALTERNATE SOU DECLARATION 



♦/ 



del 1 scux based (scup) aligned. 

(2 padO bit (36). 

2 fd. 

3 Isn bit (1). 

3 loc bit (1). 
3 la_am bit (1). 

3 Isp bit (1). 

3 Ipr bit (1). 

3 nea bit ( 1 ) . 



/♦ GROUP II FAULT DATA */ 

/♦ Illegal segment number ♦/ 

/♦ Illegal op code +/ 

/♦ Illegal address - modifier »/ 

/* illegal slave procedure */ 

I* illegal procedure »/ 

/♦ non existent address ♦/ 
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3 oobb bit (1), 
3 pad bit (29), 

2 pacl2 bit (36). 

2 pad3a bit (18). 

2 t8r_stat (0:2). 
3 prn bit (3). 
3 prv bit (1). 

2 pad3b bit (6)) unaligned. 

2 pad45 (0:1) bit (36), 

2 Instr (0:1) bit (36); 



/* out of bounds ♦/ 



/♦ T§R STATUS as an ARRAY */ 
/* PR nuhibor ♦/ 
/* PR val Id bit ♦/ 



/* Instruction ARRAY ♦/ 



/♦ END INCLUDE FILE mc.lncl.pll »/ 
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nul 1_addr esses. <ncl .pi 1 



segment In: > 1 do0 1 nc I ude 

entry modified: 10/13/82 1311.9 



contents modified: 10/ 13/82 13 10.8 



/» BEGIN INCLUDE FILE nun_addresses . Incl .pi 1 */ 

del (pc_roove_page_table_l_nul l_addr Init 
pc_move_page_table_2_nu1 l_addr Init 
get_aste_nul l_addr Init 
make_sdw_nun_addr In It 
put_aste_nu1 l_addr Init 
page_bad_pd_nu 1 1 _addr Init 
1 1st_depos J t_nun_addr Init 
get_f 1 le_map_nul 1_addr In It 
f I n_page_tab1e_nul l_addr Init 
Inl t_sst_nun_addr Init 
get_f 1 1e_map_vt_nun_addr Init 
unprotected_nun_addr Init 
paga_parl ty_nu1 1_addr Init 
page_devpar I ty_nun_addr Init 
get_f 1 1 e_map_dumper_non_nu I l_addr Init 
page_bad_nu 1 1 _addr 1 n I t 
page_problem_nun_addr Init 

del create_vtoce_four_nul l_addrs fixed bin (71) In 

del (create_vtoce_nun_addr Inlt 
update_vtoce_nun_addr Inlt 
truncate_vtoce_f 11 l_nu1 l_addr Inlt 
truncate_vtoce_nul l_addr Inlt 
pv_sa I v_nu 1 1 _addr Inlt 
pv_scav_nu1 1_addr Inlt 
volume_reloader_nul l_addr Inlt 
volurae_retrlever_nul 1_addr Inlt 
sal v_truncata_null_ad,dr Inlt 

/* END INCLUDE FILE nun_addresses. Incl .pll */ 



•3770070"b3), 
■3770100"b3). 
'3770IIO"b3). 
•3770120"b3). 
•3770l30"b3), 
•3770150"b3). 
•3770160"b3), 
'377O170"b3). 
•377020G"ba), 
•377O210"b3). 
•3770220"b3). 
'3770230"b3). 
'3770260"b3). 
'3770270"b3). 
•3777720"b3). 
'3770240"b3). 
'3770250''b3)) 



bit (221 aligned static options (constant); 



static Inlt (-1):/* 777777 777777 777777 777777 ♦/ 

"777777"b3). 
"777776"b3), 
"777775"b3), 
"777002"b3). 
" 777004 "b3). 
" 777006 "b3). 
"777774 "b3). 
»777773"b3), 
"777005"b3)) bit (18) aligned static options (constant): 



Incl .**, hard. source 
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^. .„ seament In: >)dcl>hard>source system Id: 37-20 

P'*'-^'^^ contents modified: 03/il4/83 1653.3 entry modified: 03/27/B3 1B07.2 



/« ««,»**♦»♦«*♦♦*♦♦*•***♦**»**«♦*♦♦♦•♦*♦***•*♦***♦*»♦***♦♦♦♦♦** 

• Copyright, (C) Honeywell Information Systems Inc., 1982 * 

♦♦»♦♦♦**«*****«***♦*********♦**♦*****♦****♦***♦♦*♦**♦****** */ 

/♦ PDS - The Process Data Segment 

Last modified (Date and reason): 

2/6/76 by S. Webber Initial coding .^ ^ 

9/17/76 by R. Bratt to add seg_fault, bounds_faul t , vtoc_road, and vtoc_wr1te meters. 

It/03/76 by M. Weaver to extend stack header 

04/20/77 by M. Weaver to delete rntp and 7/77 to add name template_pdi3 

06/07/7B by E. Donner to add rlng_Bvents (to prevent delayed Ipc wakeups) 

05/10/79 by B. Margul les to eliminate exmod8_leval 

05/09/79 by Mike Grady to use shared ring stacks ,^ ., _», 

08/17/79 by U. A. Bush for exp under /over flow restart switches 8. cache parity diagnostics 
02/28/eo by B. Margul les to use the Include file for the default overflow 
08/26/80 by J. A. Bush for the DPS8/70M CPU 

02/23/81 by 0. Bonglovanni to remove terap_mode_reg (moved to prds$mode_reg_enab1ed) 
03/81 by E. Donner to remove next_ltt and ect_polnters 
3/82 BIM for 1ock_array cleanup. 

11/82 by J. Bonglovanni to make force_wr1te_1 Imit per-rlng 
2/83 by E. N. KIttlltr for hfp_exponent_enabled. 
•/ 

/♦ *♦♦»»»*♦*♦*♦♦♦*♦♦*♦*♦♦***♦♦***♦**♦•♦****♦**♦♦♦**♦***** 
» * 

♦ * 

♦ Copyright (c) 1972 by Massachusetts Institute of » 

• Technology and Honeywell Information Systems, Inc. * 

• * 

♦♦♦**♦♦*♦****♦♦♦**♦*****♦**»***♦♦♦*♦**♦♦***♦♦♦******** */ 

/* format: style3. Idlnd25 ♦/ 
pds:. 

proc; 

/* This program creates the pds data base */ 
/* Automatic */ 

del 1 cdsa aligned like cds_args: 

del code fixed bin (35): 



Include . hard. source pds.cds 

F8oi Jot to be reproduced 



53 



/* Constants ♦/ 



del 
del 



pdsname 
exc)ude_pad 



char (3) aligned static 1n*t ("pds") options (constant); 

(1) char (32) aligned static options (constant) Init ("pad*"); 



/♦ Bull tins */ 



del 



(addr, bin, bit, hbound. 



mod, nul I 
bu 1 1 1 1 n ; 



rel . size, string, unspec) 



/♦ Entries ♦/ 

del cotii_err_ 

del crBate_data_seg(Ment_ 

del get_tenip_segraent_. 

del release_temp_segment_ 

dc 1 he s_$ehnafne_f 1 1 e 

del get_wdir_ 



entry options (variable); 

entry (ptr, fixed bin (35)); 

entry (char (*), ptr, fixed bin (35)); 

entry (char (♦), ptr, fixed bin (35)); 

entry (char (*), char (*), char (♦), char (*), fixed bin (35)); 

entry () returns (char (16B)); 



/♦ External Static */ 

del error_tabl»_$segnaniedup fixed bin (35) ext; 



i nc ■ . * * , hard . source 
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del pdap 

del 1 pds 

2 page_fault_data 

2 f»m_data 

2 8»gnal_data 

2 hlatory_reg_data 

2 proces8_group_1d 

2 cpu_tlme 

2 vtrtua1_delta 

2 virtual t1me_at_o1 



ptr; 

aligned based (pdsp), 

1 Ike mc, 

1 1ke mc, 

a1 tgned 1 Ike mc, 

(64) fixed bin (71). 

char (32). 

fixed bin (52). 



2 temp_1 

2 temp 2 

2 tlme^l 

2 t1me_v_temp 

2 f 1iii_v_temp 

2 f1ni_v_delta 

2 8ave_hl8tory_reg8 

2 hregs_saved 

2 1ast_sp 

2 apt_ptr 

2 arg_1 

2 arg_2 

2 arg_3 

2 arg_4 

2 access author Izatl 



fl 
tglbl 
fl 
f 1 
fl 
• fl 
f 1 
fl 
f 1 
bl 
b1 
pt 
Pt 
fl 
fl 
fl 
f 1 
on at 



xed bin 
llty 
xed bin 
xed bin 
xed bin 
xed bin 
xed bin 
xed bin 
xed bin 
t (1) al 
t (1) al 
r. 



(52). 

(52). 

(71). 

(71). 

(52). 

(52). 

(52). 

(71). 

Igned, 

Igned, 



r. 

xed bin (71). 

xed bin (71). 

xed bin (71). 

xed bin (71). 

Igned like alro_temp1ate 



2 base_addn_reg 

2 alarni_r1ng 

2 px88_args_lnvaHd 

2 process Id 

2 proce8a_ld 

2 vt1me_count 

2 pstep 

2 dstep 

2 wakeup_f1ag 

2 pc call 

2 audi t_f lags" 

2 quota_1nh1b 

2 pd_page_faults 

2 page_wa1ts 

2 number_of_page8_ln. 

2 post_purged 
2 connect_pendlng 
2 segment_fau1 ts 
2 bound8_faults 
2 vtoc_reads 

2 vtoc^^wfltss 
2 mc_trace_seg 
2 mc trace sw 



bit (18) aligned, 
fixed bin (3). 
bit (36) aligned, 
bit (0) unaligned, 
bit (36) aligned, 
fixed bin, 
bit (O) unal igned, 
(18) al Igned, 



bit 

bit 

bit 

bit 

bit 

fixed 

fixed 



(36) 
(36) 
(36) 
(36) 

bin. 

bin. 



al Igned, 
al Igned, 
a 1 1 gned , 
al Igned, 



/♦ MC for page faults and timer runouts */ 

/* MC for normal faults ♦/ 

/* storage for MC being signalled ♦/ 

/♦ this must follow signal data */ 

/* user Id for current process ♦/ 

/* number that when subtracted from clock reading gives 

virtual cpu time */ 
/* temporary used in calculating VCPU time */ 

/* temporary used In calculation of VCPU time */ 

/♦ temporary ♦/ 

/♦ temporary ♦/ • 

/♦ page fault metering time ♦/ 

/* temporary used In calculating VCPU time */ 

/* VCPU temporary for the FIM */ 

/* VCPU temporary for the FIM */ 

/* - "l"b If history registers are to be saved »/ 

/♦ - «l"b If history regs were saved ♦/ 

/♦ stack polinter at getwork time */ 

/♦ pointer i:o this process's APT entry ♦/ 

/♦ argument for pxss */ 

/* argument for pxss ♦/ 

/* argument for pxss */ 

/* argument for pxss */ 

access authorization for the process */ 

for BAR mode use */ 

setting tfor ring alarm register ♦/ 

used by pxss raasklng/arg copying code */ 

process CD (added segdef) */ 

process ID */ . 

depth counter used In VCPU calculation ♦/ 

(added segdef for dstep) ♦/ 

rel pointer to ASTE for dseg */ 

flag indicating type of wakeup ♦/ 

flag saying type of wait */ 

bits Indicating types of auditing to do ♦/ 

ON If quota checking to be inhibited */ 

faults from paging device */ 

page faults */ 



use 

fixed bin, 
fixed bin, 
bit (1) aligned, 
fixed bin (35). 
fixed bin (35). 
fixed bin (35). 
fixed bin (35). 
fixed bin. 
bit (2) aligned. 



/* 
/♦ 
/* 
/♦ 
/* 
/♦ 
/* 
/• 
/* 
/* 
/♦ 
/* 
/* 
/♦ 
/♦ 

/♦ used In calculating memory units ♦/ 

/* number of post purglngs */ -. / 

/* turned on for delayed connects to be resent by flm */ 

/* count of segment faults taken by this process */ 

/♦ count of bounds faults taken by this process */ 

/* vtoc read I/Os done for this process */ 

/* vtoc write I/Os done for this process */ 

/* seg number of object segment being traced */ 

/♦ switch for M. C. Tracing "11"b -> trace on */ 



1 nc I ude *. hard. source 
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2 stack_0_sdwp ptr aligned, 

2 stack_0_ptr ptr aligned, 

2 tc_argp ptr. 

2 tc_mask bit (72) aligned, 

2 expundf l_rest bit (1) aligned, 

2 exp_ovlf 1_rest bit (O aligned, 

2 eovfl_value bit (72) aligned, 

2 cpar_orr_data bit (72) aligned, 

2 cpar_niGm_data bit (72)' aligned, 

2 cpar_1nfo bit (36) aligned. 
2 hfp_exponent_enabled bit (1) aligned, 
2 pad_for_trace_mod16 (14) fixed bin. 
2 trace 



2 1 1 raer_t I nie_ou t 
2 t 1mer_channel 
2 teriuchannel 
2 terni_proc 
2 pi 1_inachlne 
2 val 1datlon_leve1 
2 condl t lon_name 

3 I en 

3 chars 
2 padobsolets 
2 1pa_mask 
a auto_niask 
2 r1ng_alarm_val 
2 Iock_ld 
2 mc_trace_buf 
2 pad_end_of_paae_0 
2 pathname_aro 
2 Inl t 1a1_procedure 
2 account_1d 
2 lock_array 
2 acceBs__name 

3 user 

3 project 

3 tag 
2 honie_d 1 r 
2 process_d1r_name 
2 wdir 
2 wdlr_uld 
2 transparent 
2 1tt_head 
2 max access author 



2 stacks 
2 kstp 

2 events_pend1ng 
2 BpeciaJ_channels 
2 event_masks 
2 Inlt1al_rlng 
2 1nterrupt_r Ing 
2 h1ghe3t_r1ng 



(306) fixed bin (71), 

fixed bin (52), 
fixed bin (71), 
fixed bin (71), 
bit (36) al Igned, 
f Ixod bin, 
fixed bin (3), 
a 1 1 gned , 

fixed bin (8) unaligned, 
char (31) unaligned, 
bit (36) al Igned. 
(0:7) bit (35) aligned, 
(0:7) bit (36) al Igned, 
(0:7) fixed bin, 
bit (36) aligned, 
ptr una! igned, 
bit (0) una) Igned, 
a I Igned I Ike pam, 
ptr, 

char (32) a I Igned, 
(0:19) aligned like pds_ 
al Igned, 

char (32) a I Igned, 
char (32) aligned, 
char (32) a I Igned, 
char (168) aligned, 
char (32) a I Igned, 
(0:7) ptr. 

(0:7) bit (36) al Igned, 
bit (36) a) igned, 
bit (18) aligned, 
Izatlon 

aligned like aliii_templat 

(0:7) ptr. 
ptr, 

bit (36) al igned, 
bit (36) al igned. 
(7) bit (36) a I Igned. 
fixed bin (3), 
fixed bin (3), 
fixed bin (3), 



/♦ ptr to stack sdw In dseg »/ 

/♦ ptr to base of ring O stack (wired for esd) ♦/ 

/♦ arg ptr used by tc ♦/ 

/♦ save tc mask ♦/ 

/* switch for restart Ing. exp underflows from the ftm ♦/ 

/» switch for restarting exp overflows from the flm */ 

/* value to load when restarting exp overflows from the flm »/ 

/* cache parity error data (from cache) */ 

/♦ cache parity error data (from memory) */ 

I* diagnose flag, cache level and absaddr H */ 

/* user allowed to set IR hex exp bit ♦/ 

/♦ system trace data */ 

/♦ pds$trace + 16 defines the pds for Idle procs ♦/ 

/% time out time for the process ♦/ 

/* event channel for time out event ♦/ 

/* channel used to signal process termination ♦/ 

/♦ process ID of process to signal term process */ 

/♦ nonzero if we do pi 1-1 Ike things */ 

/* ACC string for condition name */ 



/♦ IPS masks ♦/ 

/* array of automatic masks for IPS signals ♦/ 

/* used in checking validation level changes */ 

/* DID used in some locking ♦/ 

/» packed ptr to mc_trace wired buffer */ 

/* pathname associative memory */ 
/* first procedure executed in a new process ♦/ 
/♦ not used yet ♦/ 
entry, 
/» alternate form of process group Id »/ 



/* home directory */ 

/* name of process directory */ 

/♦ pointers to per-ring working directories ♦/ 

/• UID of per-ring working directories ♦/ 

/* transparent usage, mod, pd switch ♦/ 

/♦ top of present ITT list */ 



/* max authorization this user can attain */ 

/♦ per-ring stack pointers */ 

/* pointer to start of KST ♦/ 

/* special wakeups -pending */ 

/* special channels assigned ♦/ 

/* per-ring mask for special channels »/ 

/* Initial ring of execution for the process ♦/ 

/* lowest ring In which IPS interrupts are allowed */ 

/♦ highest ring in which process can run */ 



Inc' ■♦♦, hard. source 
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2 prel tnked_r1ng 

2 un1que_scu_ index 

2 max_lot_slze 

2 lot_stack_s»ze 

2 c1r_8tack_slze 

2 network_ptbt_1dx 

2 1 1 nk_nie t er 8_b i ns 

2 Hnk_nieters3"t1'"e8 

2 Hnk~niater8_pgwatt8 

2 dmpr~copy_d1r8egp 

2 dmpr_pv1d 

2 dmpr pvtx 

2 f<r8t_ca)1 

2 iiic_8ave_area 

2 inc_save_ptr 

2 mc~save_1 fiqtt 

2 useable_lot 

2 rlng_event8 

2 force write limit (O 



2 {pc_var8 

3 ap 

3 retsw 

3 save_entry_ret 

3 truncated_8tacks 

3 Chan 

3 b1ock_start_8tBp8 

3 8tk_tenip 
2 1pc_bTock_return 
2 avg_b1ock_8tep8 
2 b1ock_1ock_count 
2 pad for_data_mod16 
2 data 



bit (a) a I Igned, 
bit (36) aligned, 
(0:7) fixed bin, 
(0:7) fixed bin, 
(0:7) fixed bin, 
fixed bin. 
(4) fixed bin, 
(4) fixed bin (30). 
(4) fixed bin, 
ptr. 

bit (36). 
f 1 xed bin. 
fixed bin, 
bit (le) aligned, 
bit (18) aligned, 
bit (IB) aligned, 
bit (B) aligned, 
bit (36) aligned. 
:7) 
fixed bin, 

a1 Igned. 
pointer unal , 
fixed bin (35), 
fixed bin (35). 
fixed bin (35). 
fixed bin (71). 
fixed bin (35). 
fixed bin (35). 
bit (36). 

fixed bin (35, 18). 
fixed bin. 

(13) fixed bin (35). 
bit (0) aligned; 



/♦ blt( 1) Is ON If ring ( I ) Is prel Inked */ 

/* used to tag HC */ 

/♦ sizes lots can grow to */ 

/* size of lot In stack (O -> lot not In stack) */ 

/♦ size of CtR in stack */ 

/* Index Into NCP's process table «/ 

/* hlstogramE: of linkage faults ♦/ 

/* histogram of linkage fault times ♦/ 

/♦ histogram of linkage faults PF's »/ 

/* ptr to temp segment Into which dlrs are copied */ 

/» pvld of volume being dumped */ 

/♦ pvtx of volume being dumped ♦/ 

/♦ON until leave ring zero once */ 

/* rel polntsir to start of saved MC area */ 

/* ptr to ne>:t mc save place */ 

/♦ max addresis where MC can be saved ♦/ 

/♦ Indicates whether lot can be referenced ♦/ 

/* per-rlng Indicator that Itt messages copied to ect */ 

/♦ limit on force-writing ♦/ 

/* Following must be doubleword aligned! ♦/ 

/* holds 8tai:e of fast_hc_lpc at block */ 



/• Ipo block return address */ 
'/♦ count of locks held ♦/ 
/♦ to mark end of PDS for MC save area ♦/ 



X Include pathname_am; 

%lnclude exponent_control_lnfo; 

^Include lock_array; 



Include *. hard. source 
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/♦ for initializer »/ 



call get_teinp_segment_ ("pds", pdsp, code): 

/* Now begins the Initialization */ 

pds.process_group_id = "Inl t iai izer . SysDaemon. z' 

pds. accessi_auttnorizat ion. categories = (18)"0"b; 

pds.access_authorizat ion. level ° O; 

pds.access_authorlzat lon.dir = "l"b 

pds.access_author1zation.seg » "fb 

pds.access_author izat ion.rcp « "T'b 

pds.acces!3_author Izat ion. ipc « "1"b 

pds.accesGi_author izat ion. soos • "l"b; /♦ .. */ 

pds. niax_access_author1zation. categories = (18)"1"b jj (I8)"0"b; 
pds.inax_access_author izat Ion. level =7; 

pds. vt lme__count = -Ij 
pds.process_1d « (36)"r'b; 
pds.lock_ld = (36)"l"b: 
pds.pl 1_machlno * 1; 
pds. ips_n\ask (*) « (35)"r'b; 
pds. force_wrlte_1 Imi t (») = i; 

pds.save_history_regs. pds.hregs_saved > "0"b; 
pds.hi8tory_reg_data {*) = 0; 

pds.iinc_trace_buf •= null; 
pds.mc_trace_sw = "0"b; 
pd<?.rao_trace_seg » 0; 

pds.eovf l_value » unspec (Defaul t_exponent_control_overf I outvalue ) ; 

/* set default exp overflow restart value */ 
pds.oxp_ovf l_rest. pds.exp_undf 1_rest = "0"b; 

pds. stack_0_sdwp = null; 

pds. 3tack_0_ptr " null; 

pds .pad_f or_trace_mod16 (♦) = O; 

trace_ptr = addr (pds. trace); 

trace. Iast_ava<1able = divide (hbound (pds. trace, 1) * size {page_trace_entry ) - 8. 2. 17. O); 

pds. Init ial_procedure = null; 
pds. lock_array (*).lock_ptr = null; 
pds. lock_array ( * ) .cal ler_ptr = null; 
pds. lock_array (♦). event = ""b; 

pds. access_nanie. user = "Initializer"; 
pds .accessname. project ■= "SysDaemon"; 
pds. access_name. tag = "z"; 

pds . horoe_d i r = ">systein_control_1 " ; 

pds.process_dlr_namo = ">process_dir_dir> IzzzzzzzbBBBBBB" ; 
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pds.wdir (*) - null: 
pds.wcHr_u«d (♦) • "0"b: 

pds. stacks (*) ■ null; 

pds.dmpr_pvld ■ "0"b; 
pds.dmpr~pvtx " 0; 
pds.dmpr_copy_d1rsegp - nuH : 

pds.kstp • nul I : 
pds.f 1r8t_call « 1; 
pds, lntt«al_r»ng - 1; 
pds. Inter rupt_r1ng " 4; 
pds.htghe8t_rtng « 7; 

pds.max_lot_s»ze (♦) « 1024; 

pd8.mc_8ave_area " rel (addr (pds.data)); 

pds.mc save ptr • rel (addr (pds.data)); , .. . __ . i* 4„ au */ 

pda-mclsavelnmlt - bit (bin (4096. 18). IB): /* AHow for as many as fit In 4K. ./ 

/♦ Now make soma checks on alignment of certain variables ♦/ 

call check (addr (pds. lpc_vars) , "Ipc vars". 2): ^ ^ . ... 

call check (addr (pds.paga_faul t_data). "page_faul t_data . 16); 

call check (addr (pds. trace), "trace", 16); 

call check (addr (pda.8lgnal_data) , "8lgna1_data". 16); 

call check (addr (pds. lock array). "lock_array". 2): 

call check (addr (pds.data), "data", 16); 

If bin (rel (addr (pd3.pad_end_of_page_0)). 18) -' 1024 ,^^^ . 

then call com_err_ (O. pdsname. "Wired portion must end at 1024 ); 

/* Now set up call to create data base */ 

cdsa. sections (1).p " addr (pds); 
cdsa. sections (1).len ■ size (pds); 
cdsa. sect Ions ( 1 ) .atruct_naiiie » "pds"; 

cdsa . seg_name » "pds": 
cdsa.num exc1ude_names "1; 
cdsa.excTude_array_ptr » addr (exc1ude_pad) ; 

string (cdsa. switches) - "0"b: 
cdsa.8w1tches.have_text « "1"b; 

call create_data_segment_ (addr (cdsa). code); 

call rBlease_temp_segment_ ("pds", pdsp, code): 

call hc8_$chname_flle (get_wd1r_ (). "pds". "". »template_pds' . code): 

If code '^» O 

then If code "» error_table_$segnaraedup 



Include "*. hard. source pds.cda 
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then can com_err_ (code, pdsriame, "Unable to add name tenip1ate_pds. " ) ; 



<nc' .♦*, hard, source pds.cds "^ -^a 60 
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check : 

proc (where, message . modulo)! 



del 


where 


del 


message 


del 


modu 1 o 


del 


rema i nder 



ptr s 

.char (*); 
fixed bin: 
fixed bin: 



remainder - mod (bin (rel (where), 18). modulo); 

ihen^ealV'^eom^^rr (O, pdsname. "The variable -a Is ^^d words away from being aligned on a "d-word boundary, 
message, (modulo - remainder), modulo); 



end check: 



Includ *, hard. source pds.cda 
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>i Include cds_args; 
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% include 8ys_trace; 
Ktnclude a1ro_tenip1ate; 
^Include mc; 

end pds; 
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prds.cds segment in: :>'1dd>hard>source system 4d: 36-1 

contents modified: 07/29/81 1816.2 entry modi f led: 03/27/83 1B07.1 



/* PROS - The Processor Data Segment and Processor Stacl<. 

I* Last modified (Date and reason): 

2/5/1& by S. Webber Initial coding 

6/15/77 by M. Weaver to null signal and set pointers 

8/25/80 by d. A. Busln for the dpsB/70in cpu 

2/22/81 by J. Bonglovanni for f a8t_connect_code 

6/27/81 by J. Bonglovanni for 1d1e_temp 
*/ 

* * 

• ♦ 

♦ Copyright (c) 1972 by Massachusetts Institute of ♦ 

* Technology and Honeywell Information Systems, Inc. * 

* * 

♦ » 

prds : proc; 

/* This program creates the prds data base »/ 

/♦ Automatic */ 

dc I 1 f 1 xed bin; 

del 1 cdsa aligned like cds_args; 

del code fixed bin (35); 

/* Static */ 

del prdsname char (4) aligned static Inlt ("prds") options (consitant); 

del exclude_pad (1) char (32) aligned static options (constant) Intt ("pad*"); 

/* The following roust correspond to the size of the fast connect code in 

f ast_connBet_1n1 t ♦/ 

del FAST_C0NNECT_CODE_W0RDS init K62) fixed bin int static options (constant): 

/* Builtlns */ 

del (addr, baseptr. tain, mod, null, ptr, rel, size, string, unspee) bulltin; 

/* Entries */ 

del com_err_ entry options (variable); 

del create_data_segment_ entry (ptr, fixed bin (35)); 

del get_temp_segroent_ entry (char (♦), ptr, fixed bin (35)); 
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del release_temp_8egment_ entry (char (*), ptr. fixed bin (35))'; 
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del prdsp ptr; 



del 1 prds altgned based (prdsp), 

2 header aligned 1 tke stack_header . 

2 lnterrupt_data aligned like mc, 

2 flm_data aligned like roc, 

2 sys_troub)e_data aligned like mc, 

2 Ignoredata aligned like scu, 

2 I Itemp fixed tain (71), 

2 laat_recorded_tlnie fixed bih (71), 

2 Idlaptr ptr, 

2 slmulated_mask fixed bin (71), 

2 am_data bit (O). 

2 ptw_am_regs (4*16) fixed bin (35), 

2 ptwam ptrs (4»16) fixed bin (35), 

2 sdw_am_regs (4*16) fixed bin (71), 

2 sdw_ain_ptrs (4*16) fixed bin (35), 

2 processor_pattarn bit (8) aligned, 

2 processor_tag fixed bin (3), 

2 last_t lmer_set(tlng bit (27) aligned, 

2 depth fixed bin, 

2 inode_reg bit (36) aligned, 

2 cache_luf_reg bit (36) aligned, 

2 fault_reg bit (72) aligned, 

2 apt_ptr ptr, 

2 ldle_teiiip fixed bin (71), 



/* standard stack header */ 

/* MC for Interr-upts ♦/ 

/♦ MC for connect faults, timer runouts */ 

/* MC for saved sys trouble data */ 

/* for SCU data to be ignored at certain times */ 

/* temporary used by 11 (surprise I) */ 

/♦ used by traffic control ♦/ 

/♦ pointer to Idle process ARTE for this processor ♦/ 

/* simulated system controller mask register */ 

/* to get addr of associative memory data block */ 

/♦ page table regs (4 sets of 16 for dpsa/70m) ♦/ 

/♦ page table pointers (4 sots of 16 for dps8/70ra) ♦/ 

/♦ segment desc. regs (4 sets of 16 for dps8/70m) */ 

/* segment desc. pointers (4 sets of 16 for dpsa/70m) 

/* 1 bit ON for this processor ♦/ 

/♦ CPU tag from maintenance panel ♦/ 

/♦ last timer value loaded for this CPU ♦/ 

/♦ depth In eligible queue for running process ♦/ 

/* mode register for this processor ♦/ 

/♦ cache mode register for this CPU ♦/ 

/* place to store the fault register ♦/ 

/♦ -> apte running on this cpu •/ 

/* used by Idle process */ 



/♦ The following contains code used for handling connect faults for this processor 



•/ 



2 fast_connect_code (FAST_CONNECT_CODE_WORDS) bit 

2 f ast_connect_code_end bit (36) aligned, 

2 raode_rog_enabled bit (36) aligned, 

2 pad_mod_16 (3) fixed bin, 

2 processor_stack aligned like stack_frame; 



(36) al Igned. 

/♦ marker for f ast_connect_lnl t 
/* used to set mode register 

/* first stack frame location */ 
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call get_teinp_8egroGnt_ ("prds". prdsp. code); 
unspec (prds) » ""b; 

/* Now make some checks on alignment of certain variables */ 

can check (addr (prds. ldte_ptr) . "Id1e_ptr", 2); 

call check (addr (prds .processor_8 tack) , "proces8or_stack" . 16); 

call check (addr (prds.ptw_am_reg8). "ptw_am_regs". 16): 

call check (addr (prds. sdw_am_regs) . "9dw_am_regs" , 32); 

call chock (addr (prds. fas t_connect_code) , "fa8t_connect_code" , 2); 

/• Now set up call to create data base */ 

cdsa. sect Ions (1).p » addr (prds); 
cdsa. sections (1).len « size (prds); 
cdsa. sect Ions ( 1 ) .8truct_name - "prds"; 

cdsa.seg_nafflo • "prds"; 
cdsa.num excludG_name8 ■ 1; 
cd8a.excTude_array_ptr • addr (exclude_pad); 

string (cdsa. switches) ■ "0"b: 
cd8a.8Mltches.have_text ■ "l''b; 

call create_data_segment_ (addr (cdsa), code); 

call rBlease_temp_seBn)ent_ ("prds". prdsp, code); 
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check: proc (whercs, message, modulo); 

del where ptr; 

del message char (*); 

del modulo fixed bin; 



(f mod (bin (rel (where), 18), modulo) "= O 

then call com_err_ (O. prdsname, "The variable "a la not aligned on a "d-word boundary.", message, modulo); 



end check ; 
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% fnclude cds_arg8; 
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% tnclude stac(<_headQr; 
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% include stack_frame; 
% include mc; 

end prds: 
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ptw. 168. tnci .pi t 



segment In: 
entry modified: 



> I dd> Include 
03/10/B2 0836. 



contents modified: 07/29/81 1747.9 



/* BEGIN INCLUDE FILE ... ptw. 168 . IncI .pi 1 ... 02/26/81. for ADP conversion */ 

/* Note; This Include file has an ALM counterpart made with elf. Keep It up to date »/ 



del t 16a_core_ptw aligned based (ptp). 

2 frame fixed bin (14) unsigned unaligned, 

2 padi bit (4) unaligned. 

2 flags unaligned I il<e I68_ptw_f lags: 

del I I68_ptw aligned based (ptp). 
2 add bit (18) unaligned. 
2 flags like l6B_ptw_f lags unaligned; 

del 1 I6a_special_ptw aligned based (ptp) like I68_ptw: 
del 1 168_real_dlsk_ptw aligned based (ptp) like 16a_ptw; 
del 1 168_nun_disk_ptw al Igned based (ptp) like I68_ptw; 

del 1 16a_ptM flags unaligned based, 
(2 addtype bit (4). 
2 first bit ( 1). 
2 er bit ( 1). 



(O. 



2 padi bit (1). 

2 unusablel bit 

2 phu bit ( I ) . 

2 phm 1 bit ( 1 ) . 

2 nypd bit (1). 

2 phm bit ( t). 



2 phu I b i t (' 1 ) , 

2 wired bit (1). 

2 OS bit (I). 

2 val Id bit (1), 

2 df_no bit (2)) unaligned; 



/• In-core page descriptor */ 
/» Core frame number ♦/ 



/* General declaration for out-of-core PTW ♦/ 



/♦ Page Is somewhere peculiar -- add_type • "01"b ♦/ 

/♦ PTW for page actually on disk -- add_type - " 10"b ♦/ 

/» PTW for page not yet on disk -- add_type - "11"b ♦/ 

/♦ Various software/hardware flags ♦/ 

/♦ 0000=nul1. 1000=core. OiOO^disk, 0010=pd. 0001»swap */ 

/♦ the page has not yet been written out ♦/ 

/♦ error on last page I/O (also used by post-purge as temp) */ 



/* can't be used because hardware resets this bit */ 

/* page has been used bit «/ 

/♦ Cumulative OR of hardware phm's */ 

/* must be moved to paging device */ 

I* page has been modified bit */ 

/* page has been used in the quantum */ 

/♦ page is to remain in core ♦/ 

/• page Is out-of -service (I/O In progress) */ 

/* directed fault If this is O (page not in core) */ 

/* directed fault number for. page faults •/ 



/» END INCLUDE FILE 



ptw. 168. Incl .pi 1 */ 
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pv holdt IncJ pll segment In: >1dd><nclude contents modified: 05/13/76 1025.4 

entry modified: 03/10/82 0836.5 



/* BEGIN INCLUDE FILE ... pv_holdt . Incl -pl 1 . . . ♦/ 

del pv_hoIdtp ptr: 

del 1 pv_ho1dt (1 : 64) based (pv_holdtp) aligned, 

2 pvtx fixed bln(17) unaligned, 
2 apterp b1t(18) unaligned; 

/* END INCLUDE FILE ... pv_holdt . Incl .pl 1 ...*/ 
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pvt . Inc) .p] 1 



segment In: > 1 dd> i nc J ude contents modified: 05/20/82 I037.6 
entry modified: 05/20/82 1047.6 



/* 



BEGIN INCLUDE FILE ... pvt.lncl.pll ... last modified January 1982 */ 



/• The physical volume table (PVT) Is a wired-down table. 
It has one entry for each spindle present, be It for 
Storage System or "I/O" use. 

♦/ 



del 



pvt$ 
pvtp 



ext , 
ptr; 



del 



I pvt 



based (pvtp) aligned. 



n_entrles 

max_n_entrles 

n_ln_use 

rwun_pvtx 

shutdown_state 

esd state 



fixed bin 
fixed bin 
fixed 
fixed bin, 
fixed bin, 
fixed bin. 



(17). 

(17). 

bin ( 17). 



prev_shutdown_state fixed bin, 
prev_esd_state fixed bin. 



2 time of bootload fixed bin (71), 



root_lvld 

root_pvld 

root_pvtx 

root_vtocx 

dlsk_table_vtocx 

disk table uld 



bit (36) a I igned. 
bit (36) a I igned, 
fixed bin, 
fixed bin, 
fixed bin, 
bit (36) al Igned. 



/♦ number of PVT entries »/ 

/» max number of PVT entries ♦/ 

/» number of PVT entries In use */ 

/♦ rew1nd_un loading pvtx ♦/ 

/* state of previous shutdown */ 

/» state of ESO, >0 Iff In ESD ♦/ 

I* shutdown state of previous bootload «/ 

/* ESD state of previous bootload */ 

/♦ Time of bootload ♦/ 

/* Logical volume ID of Root Logical Volume (RLV) *l 

/♦ Physical volume 10 of Root Physical Volume (BPV) ♦/ 

/♦ Index to PVTE for Root Physical Volume (RPV) */ 

/♦ VTOCE Index for root (>) ♦/ 

/* VTOCE Index for disk table on RPV */ 

/* File System UIO for dlsk_table */ 



rpvs_reque6ted bit (t) aligned, /♦ 
rpv_needs_8alv bit (1) aligned, /♦ 
r I v_needs_8alv bit (1) aligned, /♦ 
volmap_lock_wai t_constant bit (36) aligned./* 
volmap_idle_wal t_constant bit (36) aligned./* 
vtoc_map_lock_wal t_constant bit (36) aligned, 
n_vo)map_locks_held fixed bin (17), /♦ 
n_vtoc_map_locks_held fixed bin (17), /* 



2 last_volmap_t ime fixed bin (71), 

2 la5t_vtoo_map_t Ime fixed bin (71), 

2 total_volroap_lock_t ime fixed bin (71), 

2 total_vtoc_roap_lock_t ime fixed bin (71), 

2 n_volraap_locks fixed bin (35), 

2 n_vtoc_map_locks fixed bin (35). 

2 volmap_lock_nowal t_cal Is fixed bin (35), 

2 volmap_lock_nowai t_fal Is fixed bin (35), 



RPVS keyword given on BOOT ♦/ 

RPV required (not requested) salvage */ 

RLV required (not requested) salvage */ 

For constructing wait event: OR pvte_rel into lower */ 

For constructing wait event: OR pvte_rel into lower */ 

/* For constructing wait event: OR pvte_rel into lower 

Current number of volmap locks held */ 

Current number of VTOC Map locks held */ 



♦/ 



/* Time a volmap was last locked/unlocked «/ 

I* Time a VTOC Map was last locked/unlocked */ 

/* Total time volmap's were locked (integral) */ 

/* Total time VTOC Maps were locked (integral) */ 

/♦ Number times a volmap was locked */ 

/♦ Number times a vtoc_map was locked »/ 

/* Number calls to lock volmap, no wait */ 

/♦ Number times lock failed +/ 
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2 vo1i«ap_lock_wa«t_cans fixed bin (35). /♦ Number calls to lock volmap. wait ♦/ 
2 volmap lock_walt_fall8 fixed bin (35). /* Number times lock failed */ 
2 pad (2T bit (36) aligned. 

2 array fixed bin (71): /* Array of PVTE's -- must be double-word aligned •/ 

/• END INCLUDE FItE . . .pvt . Incl .pi 1 */ 
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segment In: > I cld> t nc I ude 

entry modified: 10/13/82 1311.9 



contents modified: 10/13/82 1310.8 



/♦ START OF: 

del 
del 



pvte. IncI .pi 1 

pvt$array 
pvt$max_n_entrles 



July 1982 ♦ 

aligned external; 
fixed bin external 



•/ 



del 
del 

del 



pvt_arrayp 
pvtep 

1 pvt_array 



ptr; 
ptr; 

(pvt$max_n_entr ies) aligned I Ike. pvte based (pvt_arrayp) ; 



del 1 pvte based (pvtep) aligned. 

2 pvid bit (36), /* physical volume ID */ 

2 Ivid bit (36). /♦ logical volume ID ♦/ 

2 dmpr_ln_usa (3) bit (1) unaligned, /» pliysical volume dumper Interlock ♦/ 

2 pads bit (6) unaligned, 

2 sk ip_queue_count fixed bin (18) unsigned unaligned, /♦ number of times this pv skipped for per-proc allocation du 
e to saturation ♦/ 

2 brother_pvtx fixed bin (8) unaligned,/* next pvte In Iv chain */ 



2 devname 



char (4), 



gar table */ 



(2 devlce_type fixed tiin (8), 
2 loglcal_area number fixed bin (8), 



2 


used 


bit (1), 


2 


storage_systero 


bit ( 1). 


2 


permanent 


bit (1), 


2 


testing 


bit ( 1), 


2 


being mounted 


bit (1). 


2 


being demounted 


bit ( t). 


2 


check_read_ Incomplete bit ( 


2 


device inoperative 


bit (1). 


2 


rpv 


bit (1). 


2 


scav check address 








bit (1), 


2 


deposlt_to vol map 


bit (1). 


2 


being demounted2 


bit (1), 


2 


pad5 


bit (1), 


2 


vacat Ing 


bit (1), 


2 


hc_part_used 


bit (1). 



1), 



/♦ device name ♦/ 

/♦ device type */ 

/♦ disk drive number */ 

/* TRUE if this entry is used ♦/ 

/* TRUE for storage system (vs lo disk) */ 

/* TRUE if cannot be demounted */ 

/♦ Protocol bit for read_d1sk$test ♦/ 

/♦ TRUE if the physical volume Is being mounted */ 

/* TRUE if the pyslcal volume Is being demounted */ 

/* page control should check read incomplete */ 

/* TRUE if disk_control decides dev busted ♦/ 

/♦ tRUE if tills Is the root physical volume ♦/ 

/* TRUE is page control should check deposits/withdrawals against scaven 

/♦ TRUE If deposits should got to volume map, not stock */ 
/» No more vtoc I/O during demount ♦/ 

/♦ don't put new segs on this vol */ 
/♦ HC part set up by Initpvt ♦/ 
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2 volinap_1ock_notlfy bit (1) unal , 
2 vo»iiiap_iclle_notlfy bit (1) unal. 
2 vtoc_niap_locl<_notlfy bit (1) unal, 



2 n_free_vtoce 
2 vtoc_8lze 

2 dbmrp 

2 nieft 
2 totrec 

2 dlm_lnfo 

2 curn_dnipr_vtocx 
2 n_vtoce 

2 baseadd 
2 pad2 

2 volniap_sag_8dw 



2 vol map_a step 

2 volmap_off8et 
2 vtoc_map_of f set 



2 vo1inap_lock 
2 vtoc_map_lock 
2 vo1roap_8tock_ptr 



fixed bin (17). 
fixed bin ( 17), 

(2) bit (18). 

fixed bin ( 17), 



/* TRUE If notify required when volmap lock Is unlocked */ 

/* TRUE If notify required when volmap state Is Idle */ 

/• TRUE If notify required when vtoc map lock is unlocked ♦/ 

/* number of free VTOC entries ♦/ 

/* size of the VTOC part of the disk - In records */ 

/* rel ptr to dumber bit maps for this volume ♦/ 

/♦ number of records left */ 



fixed bin (17)) unalljined. /* Total records In this map */ 

bit (36). /♦ Information peculiar to DIM •/ 

(3) fixed bin unallgnod./* current vtocx being dumped ♦/ 
fixed bin unaligned, /* number of vtoce on this volume */ 

fixed bin (18) uns unallonod. /* Base of paging region ♦/ 
bit ( 18) unal Igned. 



fixed bin (71). 



ptr unal . 

bit (18) unal. 
bit (18) unal. 



bit (36) aligned, 
bit (36) aligned, 
ptr unal , 



/♦ SOW describing volmap_seg ♦/ 

/♦ Packed pointer to ASTE for volmap_seg ♦/ 

/♦ Offset In volmap_seg of volume map */ 
/* Offset in volmap_seg of VTOC map */ 



/• Lock on volume map operations */ 
/♦ Lock on VTOC map operations ♦/ 
/* Packed pointer to record stock ♦/ 
/♦ Packed pointer to VTOCE stock */ 



2 vtoc_map_stock_ptr ptr unal, 

2 volmap async state fixed bin (17) unaligned. /• Asynchronous update state of Volume Map */ 
2 volmaplasynclpage fixed bin (17) unaligned, /• Page number for asynchronous update •/ 



2 vol_trouble_count f 
2 8cavenger_block_re 



fixed bin (17) unaligned. /* Count of inconsistencies since last salvage */ 
I bit (18) unaligned; /* Offset to scavenger block. 'O •> scavenging */ 



del (VOLMAP_ASYNC IDLE 
vbLMAP_ASVNC_READ 
VOLMAP ASVNC WRITE 



Inlt (0), /♦ fof volmap_async_state ♦/ 

Inlt (1)! . ^ ^, 

Inlt (2)) fixed bin Int static options (constant); 



/♦ END OF: 



pvte. Incl .pi 1 



•/ 
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rnt.lncl.pll segment In; > I dd> I nc I ude contents modified: 12/16/77 1314.1 

entry modlfteid: 03/10/82 0836.6 

/♦ BEGIN INCLUDE FILE RNT.INCL.PLI - WRITTEN SEPTEMBER 1974 BY R. BRATT */ 

/» modified July 1976 by R. Bratt; updated Marcli 1977 by M. Weaver ♦/ 

/♦ modified November 1977 by M. Weaver to use PL/I offsets Instead of pointers ♦/ 

del (rntp, rntep) ptr; 

del 1th fixed bin (17); 

del based_rnt_area area based: 

del 1 rnt aligned based (rntp), 

2 areap ptr. /♦ pointer to area for rnte allocations */ 

2 meters, 
3 Insert, 

4 trys fixed bin (17) unaligned, 
4 wins fixed bin (17) unaligned, 
3 get_segno like Insert, 
3 get_ref names like insert, 
3 delete_6egno like Insert, 
3 delete_name like Insert, 
2 rnt_area_sl2e fixed bin, 
2 srulep ptr, 

2 name_hash_tab1e (0:127) offset (rnt. areap -> based_rnt_area) , 
2 segno_hash_table (0:127) offset (rnt. areap -> based rnt_area) ; 

del 1 rnte aligned based (rntep), 

2 name_fp offset (rnt. areap -> based_rnt_area ) , 

2 segno_fp offset (rnt. areap -> ba6ed_rnt_area) , 

(2 segno fixed bin(17). 

2 length fixed bin (17), 

2 name char (1th refer (rnte. length) ) )unal Igned; 



-END RNT.INCL.PLI - ♦/ 
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segment tn: 
entry modified: 



> I dd> Include 
11/19/82 1604.3 



contents modified: 11/19/82 1602.2 



/♦ START OF: 



8cavenger_data. Inol .pH November 19tt2 



*/ 



/♦ format: style3 ♦/ 

del scavenoer_data$ 



del 
del 
del 
del 
del 
del 

del 
del 
del 



scavenger_datap 
sc_ffletersp 
sc_proces8_tablep 
scavengar_b I ockp 
record_b1ockp 
scavenger_opt lonsp 



external : 

ptr; 
ptr; 
ptr; 
ptr; 
ptr; 
ptr; 



sc_n_proceases fixed bin; 
8cavenger_n_recorda fixed bin; 
seavenger2n_ovf I fixed bin; 



del 



aligned based (seavenger_datap) 



a I igned, 
bit (36) aligned, 
bit (36) aligned, 
bit (1) al Igned, 



scavenger data 
2 lock 

3 1 ock_word 

3 walt^event 

3 not1fy_8w 
2 proces8_table_ptr 

~ ptr, 
a error_8ever1ty fixed bin, 
2 meters aligned like 6c_meters, 
2 free bit (1) aligned; 



/* Lock on 8cavenger_data •/ 



/* Pointer to scavenger process table */ 

/* Severity of unexpected error condition ♦/ 

/♦ Available region •/ 



del 



sc_meter8 
2 n_scavenge 

vcpu 

clock_t1me 

n_vtoces 



aligned based (sc_metersp) , 

fixed bin (35). 

fixed bin (35), 

fixed bin (71), 

fixed bin (71). 

fixed bin (35), 



n_vtoce8_damaged 



fixed bin (35). 



n_vtoce8_per_proc 
f 
n vtoces_per_boot 
f 
n_vtoce3_f reed f 
n_vtoces_fmd f 

n_records f 

n_confllcta f 

n_fmd_conf Hcts f 
n reaT_conf 1 lets 

f 
n lost records f 



Ixed bin (35), 

Ixed bin (3S), 

ixed bin (35), 

ixed bin (35), 

ixed bin (35), 

ixed bin (35), 

ixed bin (35), 

Ixed bin (35), 
ixed bin (35); 



/« Meters ♦/ 

/♦ Number of volume scavenges */ 

/♦ Total page faults */ 

/♦ Total virtual CPU time */ 

/* Total clock time */ 

/♦ Number VTOCEs examined */ 

/* Number VTOCEs damaged by scavenge */ 

/♦ Number per-process VTOCEs freed */ 

/* Number per-bootload VTOCEs freed */ 

/♦ Total number VTOCEs freed */ 

/* Number VTOCEs wittn fm_daraaged resdt */ 

/♦ Number non-null filemap entries examined ♦/ 

/♦ Number potential conflicts detected */ 

/♦ Number potential conflicts due to fra_damaged ♦/ 

/* Number real conflicts */ 

/* Number lost records freed ♦/ 
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del 



sc_process_table aligned based (sc_process_tablep) , 

2 max_n_proce88e8 f »xed bin, /• Number of table entries ♦/ 

2 n_processes fixed bin, I* Nurober active entries */ 

2 process ( sc_n_processes refer (sc_process_table.max_n_processes ) ) aligned, 

3 processid bit (36) aligned. /• Owner. 0=>eropty */ 

3 pvtep ptr unal . /* PVTE of volume being scavenged */ 

3 blocl<p ptr unal. /• Block w/ i scavenger_data ♦/ 



f irst_block_page 

f ixed bin. 
n_block_pages fixed bin; 



/♦ Index of first page of block ♦/ 
/* Number of pages in block */ 



del 



1 scavenger_block 



n_records 

n_ovf 1 

ovf l_f ree_ix 

records 

overflow 



al Igned based (scavenger_blockp) , 

fixed bin, /* Nurober of record addresses */ 

fixed bin. /* Number of overflow blocks ♦/ 

fixed bin. /♦ Index of first free overflow block ♦/ 

( scavenger_n_records refer (scavenger_block .n_records) ) aligned like record_block , 

( scavenger_n_ovf I refer ( scavenger _block.n_ovf I ) ) aligned like record_block; 



del 



record_block 
2 vtocx 
2 pageno 
2 state 
2 lock 
2 ovflx 



aligned based (record_blockp) ,/* One per record address 
fixed bin (15) uns unal. /♦ Owning VTOCE Index */ 
fixed bin (8) uns unal. /* Owning page number */ 
fixed bin (2) uns unal. /♦ State */ 
bit (1) unal, /• Lock bit on this block 



»/ 



fixed bin (10) uns unal; 



/• Index of first overflow block on chain */ 



del 



del 



1 scavenger_data_pages 

aligned based (scavenger_datap) . 
2 page (0:255) aligned. 

3 word (1024) bit (36) aligned; 

1 scavenger_opt Ions aligned based (scavenger_opt lonsp) . 



2 print_metera 

2 debug 

2 dump 

2 trap 

2 no_optimize 



bit ( 1 ) unal Igned. 
bit ( t ) unal Igned, 
bit ( I ) una I i gned . 
bit (I) unal igned, 
bit ( 1 ) unal Igned; 



/♦ OIM => meter each scavenge into the log */ 
/* OIM => do special debugging things */ 
/♦ OIM => dump bad VTOCEs Into syserr log */ 
/* OIM => trap to BOS for debug ♦/ 
/• OIM ■•> no VTOCE read-ahead ♦/ 



del 



( 

STATE_UNSEEN 

STATE_FREE 

STATE_IN_USE 

STATE_CONFLICT 

) 



init (O). 

intt (1). 

inIt (2). 

init (3) 

fixed bin int static options (constant); 



END OF : 



scavenger_data. incl .pi 1 



♦/ 
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scs. incl .pi 1 



segment in: 
entry modtfled: 



>1dd> Include 
04/29/82 1136.4 



contents modified: 04/29/82 1127.6 



/* BEGIN INCLUDE FILE SCS. Incl. pi 1 



April 1982 */ 



/* Information about system controllers */ 

del 1 8cs$controllBr_data (0:7) aligned ext. 
2 size fixed bin (17) unaligned, 
2 base fixed bin (17) unaligned, 
2 elma_data (4) unaligned, 

3 mask_avallable bit (1) unaligned, 
3 mask_ass1gned bit (1) unaligned. 
3 robz bit (3) unaligned, 

3 roa6k_asslgnroent fixed bin (3) unaligned, 
2 Info al Igned, 

3 online bit (1) unaligned, 
3 offline bit (1) unaligned, 
3 store_a_onllne bit (1) unaligned, 
3 store al online bit (1) unaligned, 
3 store'b online bit (1) unaligned. 
3 store_b7_onllne bit (1) unaligned, 
3 store_b Ts_lower bit (1) unaligned. 
3 ex t_ inter laced bit (1) unaligned, 
3 1nt_1nterlaced bit (1) unaligned, 
3 four_word bit (1) unaligned. 
3 cycl 1c_prlor1ty (7) bit (1) unaligned. 
3 type bit (4) unaligned. 
3 abs_wtred bit (1) unaligned. 
3 program bit (1) unaligned. 
3 mbz bit (13) unaligned, 
2 lower_store_8lze fixed bin (17) unaligned, 
2 upper_store_slze fixed bin (17) unaligned; 

/♦ Information about CPUs ♦/ 

del 1 scs$processor_data (0:7) aligned ext, 
( 

2 onl ine bit (1), 
2 off 1 ine bit (1), 
2 release_mask bit (1), 
2 accept_niask bit (1), 
2 delets_cpu bit (1), 
2 Inter rupt_cpu bit (1), 
2 halted_cpu bit (1). 
2 cpu_type fixed bin (2) unsigned, 
2 mbz bit (21), 
2 expanded_por t bit ( 1 ) , 
2 expander_port fixed bin (2) unsigned. 
2 control ler_port fixed bin (3) unsigned 
) una 1 1 gned ; 



/♦ per-control ler info ♦/ 

/* size (in 1024 word blocks) of this controller */ 

/♦ abs address (O mod 1024) for base of this controller */ 

/* EIMA Information for this controller ♦/ 

/♦ ON If corresponding mask exists •/ 

/<•< ON If mask assigned to a port */ 

/* port to which mask is assigned */ 

/* ON if controller Is online */ 

/♦ ON If controller Is offline but can be added */ 

/* ON If store A Is online ♦/ 

/* ON If store Al is online ♦/ 

/* ON If store B Is online ♦/ 

/* ON If store B1 is onl Ine ♦/ 

/♦ ON If store B'ls lower */ 

/* ON If this SCU Is Interlaced with other SCU */ 

/♦ ON If this SCU Is Internally Interlaced */ 

/* ON If external Interlace Is 4-word */ 

/* Cyclic priority for adjacent ports ♦/ 

/* Model number for this controller ♦/ 

/♦ ON If controller can have ab8_wlred pages */ 

/* PROGRAM/MANUAL switch setting ♦/ 

/♦ size (In 1024 word blocks) of lower store ♦/ 
/♦ size (In 1024 word blocks) of upper-store ♦/ 



/♦ Information about CPUs In the system ♦/ 

If CPU Is onl Ine »/ 

If CPU Is offline but can be added */ 
Is this CPU Is to give up Its mask */ 
If this CPU Is to grap mask In idle loop ♦/ 
If this CPU Is to delete Itself */ 
If this CPU takes hardware Interrupts */ 
If this CPU has stopped Itself (going to BOS) */ 
«> DPS or L68, 1 •> DPS8 */ 

/♦ »i"b ■ on expanded port ♦/ 
/♦ The actual expander port */ 

/* Port on controller */ 



/* 


"1"b 


/• 


"1"b 


/♦ 


"1"b 


/» 


"1"b 


/* 


"1"b 


/♦ 


»1"b 


/♦ 


"1"b 


/• 


•: 
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del 



1 scs$port_data (0:7) aligned externa) static, 
3 assigned fixed bin (4) unsigned unaligned, 
2 expander_port bit (1) unaligned, 
2 expanded_cpu (0:3) bit (1) unaligned, 
2 loro_number fixed bin (3) unsigned unaligned, 



/* Info about what Is connected to each SCU port */ 

/♦ Type of device on this port ♦/ 

/» " r'b "> this port has a port expander ♦/ 

/♦ " r'b => this expander port has a CPU attached ♦/ 

/* lOM number of lOM attached to this port */ 



cpu_nuniber (0:3) fixed bin (3) unsigned unaligned. /» CPU number of CPU(s) attached to this port ♦/ 

/♦ cpu_number (O) Is only one If expahder_por t Is "0"b */ 
pad bit (12) unaligned; 



del 



/* Actual connect words */ 

/♦ Expander COW'S must be odd -word ♦/ 



t scs$cow (0:7) aligned externa), 

2 pad bit (36) aligned, 

3 cow, 
3 sub_mask bit (Q) unaligned, 
3 mbzl bit (13) unaligned, 
3 expander_coramand bit (3) unaligned, 
3 mbz2 bit (2) unaligned, 
3 expanded_port bit (1) unaligned, 
3 expander_port fixed bin (3) unsigned unaligned 
3 mbz3 bit (3) unaligned, 
3 control ler_port fixed bin (3) unaligned unsigned;/* controller port for this CPU */ 



/• Expander sub-port mask */ 

/* Expander command. ♦/ 

/♦ "i|"b = on expanded port */ 

/♦ Port on expander for cioc ♦/ 



del t scs$cow_ptrs (0:7) external aligned, 
2 rel_cow_ptr bit (18) una), 

2 pad bit (12) una I . 

3 tag bit (6) unal ; 



/* Pointers to COW s */ 

/♦ Rolatlve pointer to COW */ 

/* Bcitter be zero. */ 

/* Used during reconf Ig ops. */ 



del 1 scs$reconf ig_general_cow aligned external, 
2 pad bit (36) aligned, 
2 cow, 

3 sub_mask bit (B) unaligned, 

3 mbzl bit (13) unaligned, 

3 expander_coromand bit (3) unaligned, 

3 mbz2 bit (9) unaligned, 

3 controner_port fixed bin (3) unaligned unsigned;/* controller port for this CPU */ 



/♦ Connect operand word. In odd location. */ 
/* Expander sub-port mask ♦/ 

/♦ Expander command. *./ 



/• MASKS and PATTERNS */ 

del scs$sy3_level bit (72) aligned ext; 

del scs$open_level bit (72) aligned ext; 

del scs$processor_start_mask bit (72) aligned ext; 

del scs$cpu_test_mask bit (72) aligned ext; 

del scs$number_of_raasks fixed bin ext; 

del scs$processor_start_pattern bit (36) aligned ext; 

del scs$cpu_test_pattern bit (36) aligned ext; 

/* CAM and CACHE clear Info ♦/ 

del scs$eam_palr fixed bin(71)extj 
del scs$eam_wa1t bit (B) aligned ext; 

/♦ MASKING INSTRUCTIONS » POINTERS »/ 

del scs$set_mask (0:7) bit (36) aligned ext; 
del scs$read_mask (0:7) bit (36) aligned ext; 



/♦ mask used while handling I/O Interrupts ♦/ 

/♦ mask used during normal operation */ 

/♦ mask used when starting up a CPU */ 

/♦ mask used for ISOLTS CPU testing »/ 

/* number of masks (starting at sy3_level) ♦/ 

/* SMIC pattern used to send processor start Interrupt ♦/ 

/* SMIC pattern used for ISOLTS processor testing */ 



/♦ instructions XEDd when CAMIng and clearing CACHE */ 
/♦ Used when evicting pages from main memory */ 



/♦ Instructions to set mask (STAO or SMCM) ♦/ 
/* Instructions to read mask (LLiAQ or RMCM) */ 



include.**, hard. source 
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del sostmask_ptr (0:7) ptr unaligned ext; /♦ pointers for real or simulated masks */ 

/* MISCELLANEOUS ♦/ 

del 1 scs$processor_te8t_data aligned ext. /* Info used for cpu testing */ 

i „^...,„ h«* ii\ /* • "l"b If cpu currently under test */ 

2 sou state bit (2). /* s*"*® °f ^cu being used for testing (see definition below) */ 

2 padi bit (15), , _ ^ * * ., / 

2 cDu taa fixed bin (5). /* *aa o' '^P'^ under test ♦/ 

2 sCuItag nxed bin (b!: /* tag of scu being used for cpu testing */ 

) unallgnedr'*^'* "'" ^^^ /* ♦«0 «' •"=*'^« '^P" **^^* ^*^ '""'* aslgned to above scu ./ 

/* scu state • "00"b ■> SCU defined by scs$processor_te3t_data.8eu_tag not yet effected ♦/ 

/• scu^state - "01"b -> all core removed from SCU. port mask not yet changed ♦/ 

/♦ scu state • " 10"b •> all core removed from SCU, port mask changed ♦/ ' ^ ^ , 

/* sculstate - "11-b •> only 64k at base of SCU being used for testing, original port mask restofed ♦/ 

del scs$ldl9_aptep (0:7) ptr unaligned exf, /» pointer to Idle process APTE for each processor */ 

del 8cs$connect lock bit (36) aligned ext; /* lock for sending connects */ 

del scs$reconfl5 lock bit (36) aligned ext; <* '■*"=\ "!!^T '"? '' ™ml 2tnL.na ./ 

^oi ooBtfrnnKia fiaaa bit (8) al loned ext: /* Checkoff flags for sys_trouble stopping */ 

de scsSbos rlstart^^lai, LVt (si^-Hgned'ext ; /* checkoff flags for restarting after sys.trouble */ 

del scs$npr5ce3sor8~f Ixed bin ext: /* number of runnung processors ♦/ 

dc scs$bos_processor tag fixed bin (3) ext; /* CPU tag of processor ;;"""'2S-mL {/ 

dc scstfauTts Initialized bit (1) aligned ext; /♦ ON after faults have been enabled */ 

del lesisys tr5uSie_?endlnfl bit (!) aligned ext; /♦ sys.trouble event Is pending In the system ♦/ 

del 8cs$fast cam pending (0:7) bit (36) aligned ext: /♦ checkoff cells for cam connect */ 

del sc8$lnterrupt controller fixed bin (3) ext; /* port number of low order control ler */ 

de lcs$proeessor-8tart Int no fixed bin (5) ext; /* Interrupt cell for starting a processor •/ 

del scs4Droeessor~blt (I) aligned ext; /* bits ON for online CPUs ♦/ 

dc! scsjproeessorjtirilialt bit (8) ;i Igned ext: /* checkoff flags for waiting for new processor */ 

del scs$trouble_dbrs (0:7) fixed bin (71); ' /* DBR values at" system crash time */ 

del scs$port_addresslng_word (0:7) bit (3) aligned ext; /* active module port number for each controller */ 

del scs»cfg_data (0:7) fixed bin (71) aligned ext; /♦ RSCR-CFG data from each controller ♦/ 

del scs$cfg_data_save fixed bin (71) aligned ext; 7* RSCR-CFQ save area for ISOLTS CPU testing */ 

del ses$expanded ports bit (1) unaligned dim (0:7) external: 

-^ /♦ Which ports have expanders ♦/ 




scs$proce 
dell 8cs$processor_datB_8wltch_value bit (36) aligned eixt; /♦ Correct value for CPU data switches ♦/ 

del scs$controller conflg size (0:7) fixed bin (14) aligned ext: 

- /* Controller size on conflg card ♦/ 



, — _— — — ; ; r-j — — ~ ~ ~ "^ " ^ge 83 
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del scs$reconf tg_)ocker_1d char (32) aUgned ext; /♦ process group ID of process doing reconfiguration •/ 

dc) scs$scas_page_table (0:3I) bit (36) aligned external static; 

/♦ PTWs for SCA5 pages */ 

del scs$cyc1e_priority_template bit (7) aligned ext; /• template for setting anti-hog switches »/ 

del scs$set_cycle_swi tches bit (I) aligned ext; /♦ flag to set ant-hog switches »/ 

dc I ( 

IOM_PORT init (1). 
CPU_PORT Init (2), 
BULK_PORT init (3) 
) fixed bin int static options (constant): /♦ values for scs$port_data. assigned ♦/ 

/♦ END INCLUDE FILE scs.incl.pl1 •/ 



Include. +*, hard. source scs.inc1.pH Page B4 
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sdw. 168. 1 net .p) 1 



segment in: 
entry modified: 



> I dd> i nc 1 ude 
03/10/82 0836.9 



contents mod* fled: 07/29/81 1747.8 



sdw. 168. IncI .pi 1 ... Updated for ADP conversion 03/01/81 ♦/ 



/* BEGIN INCLUDE FILE ... sdw. 168 . IncI .pi 1 ... Updated for aup converoion yjj/vw' -/ 
/♦ Note: This Include file has an ALM counterpart made with elf. Keep It up to date */ 

del 1 168_sdw based (sdwp) aligned. /* Level 68 Segment Descriptor Word ♦/ 

/* main memory address of page table */ 
/• ring brackets for the segment */ 



(2 add bit (24), 
a rings, 

3 rl bit (3). 

3 r2 bit (3), 

3 r3 bit (3), 

2 valid bit (1), 

2 df no bit (2), 



padi bit (1). 

bound bit (14), 

access, 

3 read bit (1). 

3 execute bit (1). 

3 write bit (1). 

3 privileged bit (1), 

unpaged bit ( 1 ) . 

not_a_gate bit (1), 

cache bit (1), 

entry_bound bit (14)) unaligned; 



/♦ directed fault bit (0 •> fault) */ 
/* directed fault number */ 

/♦ boundary field (in 16 word blocks) */ 

/* access bits */ 

/* read permission bit */ 

/* execute permission bit */ 

/* write permission bit */ 

/♦ privileged bit */ 

/* segment Is unpaged If this is 1 ♦/ 

/♦ If this Is the entry bound Is checked by hardware */ 

/♦ cache enable bit */ 

/♦ entry bound ♦/ 



/* END INCLUDE FILE 



sdw. 168. IncI. pit */ 
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sdw_(nfo. (ncl .pi 1 



segment in: 

entry modlf led: 



> I dd> I nc 1 ude 
03/10/82 0836.9 



contents modified: 07/29/81 1747.8 



/♦ BEGIN INCLUDE FILE ... sdw_lnf o. IncJ . pM ... 12/I6/80, for ADP conversion ♦/ 

/* Note: This Include file has an ALM counterpart made with elf. Keep It up to date ♦/ 



del sdw_lnfo_ptr pointer; 

del 1 sdw_lnfo aligned based (sdw_lnf o_ptr ) . 
2 address fixed hirk (26), 
2 size fixed bin ( 19), 

2 access unaligned, 

3 read bit (1) unaligned, 

3 execute bit (1) unaligned, 

3 write bit (1) unaligned, 

3 privileged bit (1) unaligned, 

2 padi bit (32) unaligned. 

2 rings unaligned, 

3 r1 bit (3) unaligned, 
3 r2 bit (3) unaligned. 
3 r3 bit (3) unaligned. 

2 pad2 bit (27) unaligned, 

2 flags a1 Igned, 

3 paged bit (1) una I i gned , 
3 faulted bit (1) unaligned, 
3 cache bit (1) unaligned, 
3 pad3 bit (33) unaligned, 

2 gate_entry_bound fixed bin (14)j 

/* END INCLUDE FILE ... sdw_inf o. Incl .pi 1 ♦/ 



/* Structure describing SDW contents */ 

/* Address of seg base or of page table ♦/ 

/* MaiK length of segment (NOT offset of last word) */ 

/♦ REWP »/ 



I* Rling brackets */ 



/♦ "Kb => Segment is paged ♦/ 

/♦ "l"b -> SDW has fault set ♦/ 

/» "i"b => Segment is encacheable •/ 



/» Number of entrypoints in gate, or zero */ 



Include.**, hard. source 
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slonaller stack. inci .pi i segment In: > I dd> t nc 1 ude contents modified: 04/02/79 1405.9 

entry modified: 03/10/82 0836.7 



/* BEGIN INCLUDE FILE ... slgnaner_stock. Incl .pi 1 ... Created Feb 79 by D.Spector •/ 

/♦ This file matches signal ler_8tack. Incl .aim and Is currently used only by verlfy_1ock */ 

declare 1 signal ler_8tack based unaligned, 

2 pad (8) bit (36), /♦ Hake machine conditions O mod 16 ♦/ 

2 mach_cond (48) bit (36). /♦ Machine conditions ♦/ 

2 mc_ptr ptr aligned, /♦ Pointer to machine conditions ♦/ 

2 null_ptr ptr aligned, /* Null pointer ♦/ 

2 strlng_descrlptor bit (36), /♦ Condition name descriptor ♦/ 

2 ptr_da8crlptor bit (36). /* M.C. ptr descriptor */ 

2 argllst (18) bit (36), /* Arg list for call to signal */ 

2 signal string char (32), /♦ Condition name ♦/ 

2 on_un1t (16) bit (36), /♦ Must be at 128 In stack frame ♦/ 

2 hlstory_reglsters (128) bit (36); 

/* on unit must start at 128 because trap_cal ller_cal.ler_ siets up a stack frame 
assuming this to be so. Similarly mach_cond must start at 48. */ 

/* END INCLUDE FILE ... signal 1er_stack. Incl .pi 1 ... */ 



Includ' •♦, hard. source signal l«r_8tacl' 'ncl.plt '^->ge 87 
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s ) t . 1 nc I . p I 1 



segment tn: 
entry tnodtf led: 



> ] dd> ( nc 1 iide 
05/12/82 1254. 



contents modified: 05/12/82 1246.5 



/* BEGIN INCLUDE FILE Slt.lnc1.pl1 



Last modified 2/76 SHW ♦/ 



/* Declarations for Segment Loading Table header and array. 

Used by Initialization and MST Checker subroutines */ 

del si tp ptr , 

names_ptr ptr, 
namep ptr, 
pathp ptr, 
aclp ptr; 

declare 1 sit based (sitp) aligned, 
2 name_seg_ptr ptr, 
2 free_core_start fixed bin (24), 
2 f lrst_sup_seg fixed bin 08), 
2 1ast_sup_seg fixed bin (18), 
2 f lrst_lnlt_seg fixed bin (18), 
2 1ast_1n1t_seg fixed bin (18), 
2 f ree_core_slze fixed bin (24), 
2 seg (0:8191) aligned, 

3 site (4) fixed bin (35); 



/* pointer to base of SLT segment */ 

/♦ pointer to base of SLT names segment */ 

/* pointer to segment name list block */ 

/♦ pointer to segment's directory path name */ 

/♦ pointer to acl structure */ 

/* declaration of Segment Loading Table (SLT) */ 

/♦ words 0-1, pointer (ITS pair) to name segment ♦/ 

/* word a,* start of free core after perm-wired ♦/ 

/* word 3, first supervisor segment number »/ 

/* word 4, last supervisor segment number */ 

I* word 5, first initializer segment number */ 

/* word 6, last Initializer segment number */ 

/♦ size (In words) of free core after perro-wlred */ 

/♦ segment entries (4 words each) ♦/ 

/♦ Space for SLT entries ♦/ 



/* auxiliary segment of SLT for storing of segment names and directory path names */ 



declare I name_seg based (names_ptr) aligned. 
2 pad bit ( 18) unal . 
2 next_1oc bit (18) unal, 
2 ht (0:127) bit (18) aligned; 

declare 1 segnaro based (namep) aligned. 
2 count fixed bin (17). 
2 names (SO refer ( segnam. count )) , 

3 hp bit ( 18) unal , 

3 ref bit (1) unal , 

3 pad bit (5) unal , 

3 segno bit (12) unal, 

3 name char (32) unal; 

declare 1 path based (pathp) aligned, 
2 size fixed bin ( 17), 

2 name char (168 refer (path. size)) unal, 
2 ads fixed bin; 

declare 1 acis based (aclp) aligned, 
2 count f ixed bin, 
2 acl (SO refer (acls.count ) ) , 

3 user id char (32) , 

3 mode bit (36) aligned. 



/* name segment header */ 

/* Next available free location In name seg */ 
/♦ Names hash table ♦/ 

/* declaration for segment name block */ 

/* number of segment names in this block */ 

/♦ segment name array ♦/ 

/♦ hash thread pointer */ 

/* "1"b if name referenced */ 

/* segment number associated with this name */ 
/* space for name (max 32 characters) '•'/ 

/* declaration for directory path name */ 

/* length of pathname */ 

/♦ directory path name ♦/ 

/* ACL list starts here ♦/ 

/* declaration for acl list »/ 

/• number of entries in acl list */ 

/» array of acl entries ♦/ 

/♦ user specification ♦/ 

/* mode for the specified user */ 



include. ♦♦, hard. source 
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3 pad bit (36) altgned, 
3 code fixed bin; 



/* END INCLUDE FILE sit.lnol.pll */ 



tnclud' *, hard, source si t . Iriol .pt 1 
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si te. Inc) .p) t 



segment In: 

entry modified: 



> 1 dd> i nc I ude 
10/06/82 1359. 



contents modified: 10/06/83 1356.3 



/* BEGIN INCLUDE FILE site. Incl. pit »/ 

/♦ Declaration for Segment Loading Table Entry structure. 

Used by Initialization, MST Generation, and MST Checker subroutines */ 
/* last modified 5/4/76 by Noel I. Morris ♦/ 
/* format: styles ♦/ 



del 



del 



si tep 



ptr ; 

based (si tep) aligned. 





( 2 


names_ptr 


bit 


18). 






2 


path ptr 


bit 


IB). 




/ * * * * 


End of word 1 */ 










2 


access 


bit ( 


4). 






2 


cache 


bit 


1). 






2 


abs_seg 


bit 


1). 






2 


f 1rmware_seg 


bit 


1). 






2 


layout_seg 


bit 


1). 






2 


padi 


bit 


4), 






2 


wired 


bit 


1). 






2 


paged 


bit 


1). 






2 


par_proce8s 


bit 


1). 






2 


pad3 


bit 


2). 






2 


acl_prov1ded 


bit 


1). 




/**** 


End of 


1st half of word 


2 */ 








2 


pad4 


bit 


3). 






2 


branch_requ 1 red 


bit 


1). 






2 


1nlt_seg 


bit 


(1). 






2 


temp_seg 


bit 


O. 






2 


1 lnk_prov1ded 


bit 


[1). 






2 


1 1nk_sect 


bit 


1). 






2 


1 1nk_sect_w1rBd 


bit 


O. 






2 


comb1na_l Ink 


bit 


1). 






2 


pre_l Inked 


bit 


1), 






2 


defs 


bit 


1). 




/**+♦♦ 


End of 


word 2 ♦/ 










2 


pad5 


bit 


6). 






2 


cur_length 


f 1xe( 


i bin 


(9) uns. 




2 


r ingbrack 


(3) 1 


Fixed 


bin (3) uns 




2 


segno 


f ixec 


i bin 


(18) uns. 


/»*♦♦♦ 


End of 


word 3 */ 










2 


pad? 


bit 


3). 






2 


roax_length 


f Ixec 


i bin 


(9) uns. 




2 


bl t_count 


f Ixec 


i bin 


(24) uns 




) 




unal 


igned 




del 


1 s 


te 


basec 


i (sH 


ep) a1 Igned 




( 2 


names_ptr 


bit 


18), 






2 


path_ptr 


bit 


18), 






2 


access 


bit 


4). 





/* r«il pointer to thread of names */ 

/* rel pointer to pathname (If present) ♦/ 

/* SOW access bit (REWP) */ 

/* Segment to be allowed in cache */ 

/* segment is an abs seg if ON */ 

/* load in low 256 •/ 

/* mailbox & such */ 

/♦ unused ♦/ 

segment is wired if ON 



/♦ 

/* segment Is paged if ON 

/♦ segment Is per-process 



'/ 
♦/ 
if ON ♦/ 



/♦ ON If acl structure follows path_name on MST ♦/ 

/* path name supplied if ON */ 

/♦ segment is init_Beg if ON */ 

/* segment is terap_seg If ON */ 

/* I linkage segment provided if ON ♦/ 

/* segment is linkage segment if ON */ 

/* linkage segment Is wired if ON */ 

/* linkage Is combined If ON «/ 

/* lot entry tias been made if ON •-/ 

/» scigment Is definitions segment if ON ♦/ 

/♦ current length of segment (in 1024 word blocks) ♦/ 

/♦ r.llngbrackets */ 

/♦ text/link segment number ♦/ 

/* maximum length for segment ♦/ 

/* bdtcount of segment */ 



/* rel pointer to thread of names */ 

/* r-el pointer to pathname (if present) */ 

/* SDW access bit (REWP) «/ 
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2 cache 

2 abg_seg 

2 f trHiware_seg 

2 layout_seg 

2 pad2 

2 wired 

2 paged 

2 per_process 

2 pad3 

2 ac1_provlded 

2 pad4 

2 branch_requtred 

2 <nlt_5eg 

2 tenip_seg 

2 1 lnk_prov1ded 

2 1 lnk_8ect 

2 J 1 nk_6ec t_w I red 

2 combtne_1 Ink 

2 pre_l inked 

2 defs 

2 pads 

2 cur_ length 

2 rlngbrack 

2 segno 

2 pad6 

2 max_1ength 

2 blt_count 

) 



bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
(3) 
bit 
bit 
bit 
bit 



(1 
(1 
(1 
(1 
(4 
(1 
(1 
(1 
(2 
(t 
(3 
(1 
(1 
(1 
(1 
(1 
(1 
(1 
(1 
(1 
(6 
(9 
b1 
(1 
(3 
(9 
(24) 



(3). 



unal Igned; 



/* Segment to be allowed in cache. */ 
/* segment Is an abs seg if ON */ 



/* segment Is wired If ON */ 
/♦ segment Is paged If ON ♦/ 
/♦ segment Is per-process If ON */ 



/♦ ON If acl structure follows path_name on MST ♦/ 



/* 
/* 
/♦ 
/* 
/* 
/♦ 
/* 
/♦ 
/* 



path name supplied If ON */ 

segment Is ln1t_seg if ON ♦/ 
Is temp_seg If ON */ 
segment provided If ON ♦/ 
Is linkage segment If ON */ 
segment Is wired If ON */ 
Is combined If ON ♦/ 

lot entry has been made If ON */ 

segment Is definitions segment If ON */ 



segment 
1 Inkage 
segment 
1 Inkage 
1 Inkage 



/* current length of segment (In 1024 word blocks) */ 

/* rlngbrackets »/ 

/* text/1 Ink segment number */ 

/♦ maximum length for segment •/ 

/* bltcount of segment */ 



/* END INCLUDE FILE sUe.lnc1.p11 ♦/ 
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ss t . inci .pll 



segment 
entry 



in: 
mod I f 1 ect : 



> I dd> i nc I ude 
11/19/62 1604. 



contents modified; 1i1/19/82 1602.2 



/♦ BEGIN INCLUDE FILE ... sst.tncl.pH ... January 197 1 */ 

/* Note: This Include file has an ALM counterpart made with cif. Keep It up to date */ 



del sat_se9$ external; 
del sstp ptr; 

del 1 sst based (sstp) aligned, 
2 space (8) fixed bin, 

/* SST HEADER ♦/ 

2 pre_page_t ime fixed bin (71), 
2 post_purQQ_t ime fixed bin (71), 
2 post_1n_core fixed bin, 
2 thrashing fixed bin, 
2 npfs_misses fixed bin, 
2 salv fixed bin, 

2 pti bit (36). 

2 asti bit (36), 

2 astl_event bit (36). 

2 ast l_not i f y_requested bit (1) aligned, 

2 nused fixed bin. 

2 ptwbase fixed bin (24). 

2 tfreep ptr. 

2 astap ptr, 

2 bull<_pvtx fixed bin (8) aligned. 

2 ptl_walt_ct fixed bin. 

2 astsize fixed bin. 

2 cmesize fixed bin. 

2 root_astep ptr, 

2 pts (0: 3) fixed bin. 
2 level (0:3). 

3 (ausedp, no_aste) bit (IS) unaligned. 

2 (atempp. atemppi) bit (18) una I. 
2 dm_enabled bit (1) aligned, 
2 (ainitp, alnttpi) bit (18) unal, 
2 strsize fixed bin, 

/* CORE MAP HEADER ♦/ 

2 cmp ptr, 

2 usedp bit (18). 

2 wtct fixed bin. 



/* empty space to watch for bugs */ 



/♦ total time spent pre-paglng */ 

/♦ total time spent post-purging */ 

/* total pages in core (and in list) at purge time */ 

/♦ meter of thrashing being done on system ♦/ 

/♦ meter of times npfs was on when pre-paglng ♦/ 

/♦ flag which is "'0 If and only If salvaging */ 

/* global page table loop lock */ 

/♦ global ast allocation block lock •/ 

/* ev«)nt used when waiting for AST lock */ 

/♦ flag to notify AST lock ♦/ 

/♦ number of pages on used list ♦/ 

/* absiolute address of page table array */ 

/♦ pointer to first trailer on free list ♦/ 

/♦ aste array pointer */ 

/♦ pvtx of bulk store, zero if none */ 

/* pxss: number is >' # of processes waiting to ptI */ 

/♦ size of an AST entry ♦/ 

/♦ size of a CME entry ♦/ 

/* pointer to the root AST entry ♦/ 

/* array of page table sizes */ 

/* per- list information about ASTE's ♦/ 

/* us«d list and count of number of entries ♦/ 

/♦ temp sag list pointer ♦/ 
/♦ ON => journal seg exists ♦/ 
/♦ inlt seg list pointer */ 
/♦ Trailer size In words. */ 



/♦ pointer to start of core map */ 

/♦ pointer to first used core block »/ 

/* count of pages being written */ 
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2 startp btt ( 18). 
2 removep bit (18), 



2 double__wrl te fixed bin. 



2 temp_w_event bit (36) aligned, 

2 root_pvtx fixed bin. 

2 ptw_flr8t bit (1) aligned, 

2 nolock bit (1), 

2 x_fsdctp bit ( 18). 

2 fc_8klps_plnned fixed bin (35). 

2 cl_sklps_plnned fixed bin (35). 

2 ast_ht_ptr ptr. 

2 ast_ht_n_bucket8 fixed bin, 

2 ast_ht_uTd_ma8k bit (36) aligned, 

2 meter_ast_Tocklno fixed bin. 

2 check8uni_f llemap fixed bin, 

/* 100 octal */ 

2 page_read_error8 fixed bin. 
2 page_wr 1 te_error8 fixed bin. 
2 rw8_rGad_error8 fixed bin, 
2 rws~wrlte_error8 fixed bin. 

2 eye le_pv_al location fixed bin, 

2 n_trallers fixed bin, 

2 synch_actlvatlon8 fixed bin (35), 

2 synch_sklps fixed bin (35). 

2 1ock_walts fixed bin. 
2 total_1ocks_set fixed bin, 
2 pdlr_page_faul t8 fixed bin. 
2 lGve1_1_page_fau1t8 fixed bin. 
2 dlr_page_fauTts fixed bin, 
2 rlng_0_page_fault8 fixed bin, 
2 rqover fixed bin (35), 
2 pc_lo_walts fixed bin. 



/* pointer 
/* pointer 
/• MISC */ 



to solid page for lap counting (fsdct) */ 
to list of pages being removed from use «/ 



/* trigger for store through scheme ♦/ 
/* O - no double writes, 

1 " all non-pd pages get written. 

2 - all directories get written */ 
/* wait event for temp wiring lock »/ 

/* pvtx or rpv ♦/ 

/♦ flag controlling when pages go to pd ♦/ 
/* If on. don't lock pti on Interrupts */ 
/• removed by thvv */ 

/* number of skips over pinned page In flnd_core */ 

/♦ number of skips over pinned page In c1alm_mod_core ♦/ 

/* AST hast table pointer */ 

/♦ number of buckets In AST hash table */ 

/• mask to strip out low-order bits of uld */ 

/* non-zero enables AST lock meters */ 

/• non-zero enables f llemap checksumming */ 



/* read errors posted to page control ♦/ 
/* write errors posted to page control ♦/ 
/♦ read-side rws errors ♦/ 
/♦ wrlte-slde rws errors ♦/ 

/* flag to cycle VTOCE allocation among PVs */ 

/* Number. of trailer entries In 8tr_seg */ 

/* Activation attempts for synchronized segs ♦/ 

/* get_aste skips because not synchronized */ 

/♦ Number of times we had to wait for a lock ♦/ 

/* Total number of block locks set */ 

/* total page faults off >pdd ♦/ 

/* total page faults In sys I Ibes */ 

/* Total page faults on directories */ 

/* page faults In ring O */ 

/♦ errcode for record quota overflow */ 

/♦ Number of times pc had to wait on lo */ 



/* The following (until pdmap) used to be the 'cnt' In cnt.lncl.pl1 ♦/ 



2 


steps fixed bin. 


2 


needc fixed bin. 


2 


eel 1 1ng fixed bin. 


2 


ctwalt fixed bin. 


2 


wired fixed bin. 


2 


laps fixed bin. 


2 


sklpw fixed bin. 



/♦ number of steps taken around used list */ 

/* number of times core page needed */ 

/* number of times celling hit */ 

/♦ number of times write counter was full */ 

/♦ number of pages wired by pc */ 

/* number of times around used list ♦/ 

/* number of pages sklped because they were wired */ 
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2 sk Ipu f ixed bin. 



/* because of being used •/ 



2 sk 1pm f Ixed bin, 

2 sklpos f Ixed bin, 

2 sklpspd fixed bin, 

2 aused fixed bin. 

2 daraaged_ct fixed bin,, 

2 deact_count fixed bin, 

2 demand_deact_atteinptE> fixed bin, 

2 demand^deact 1 vat ions fixed bin, 

2 reads (B) fixed bin. 
2 writes (8) fixed bin, 

2 short_pf_count fixed bin, 

2 loop_ locks fixed bin, 

2 loop_lock_tlroe fixed bin (71), 

2 cpu_sf_tirae fixed bin (71), 

2 totalsfpf fixed bin, 

2 total_sf fixed bin. 

2 pre_page_size fixed bin, 

2 post_l ist_slze fixed bin. 

2 post_purglngs fixed bin, 

2 post_purge_cal la fixed bin, 

2 pre_page_cal Is fixed bin, 

2 prepagel ist_si2e fixed bin, 

2 pre_page_mis5es fixed bin, 

2 pre_paglngs fixed bin, 

/* 200 octal ♦/ 

/* TEMPORARY WIRED PROCEDURE INFO */ 

2 wire_proc_data (8) fixed bin (71), 

/* MAIN MEMORY USAGE INFORMATION */ 



I* because of being modified */ 

/* because out of service */ 

/* number of times a block of core was skipped for active rws 

/» number of AST entries on used list */ 

/* count of segments that system damaged */ 

/♦ count of deactivations */ 

/♦ usesr requested deactivations •/ 

/* usEir instigated deactivations */ 

/» number of reads for each did ♦/ 
/» number of writes for each did »/ 

/* count of page faults on out of service pages */ 

/• count of times locked PTL ♦/ 

/* time spent looping on PTL */ 

/* cpu time spent in seg_fault */ 

/* total page faults while in seg_fault */ 

/* total number of seg_faults ♦/ 

/♦ total pre-pagings expected ♦/ 

/♦ total number of post-purgings ♦/ 

/♦ total number of calls to post-purge */ 

/♦ total number of calls tp pra-page ♦/ 

/* total number of misses in pre-page list */ 
/♦ total number of pre-pagings */ 



/♦ data for wlre_proc ♦/ 



2 abs_wired_count fixed bin, 
2 system_type fixed bin, 
2 wired_copies fixed bin, 
2 recoples fixed bin. 
2 f lrst_core_block fixed bin, 
2 last_core_block fixed bin. 
2 fw_retries fixed bin (35). 
2 pvhtp ptr unaligned, 

/* AST METERS »/ 

2 asklpslze (O: 3) fixed bin, 
2 aneedslze (O: 3) fixed bin, 

2 stepsa fixed bin. 
2 asklpsehs fixed bin, 
2 asearches fixed bin, 
2 askipslevel fixed bin, 



/* count of abs-wlred pages */ 

/♦ ADP_SYSTEM or- LBBSYSTEM */ 

/• number of times a wired page was copied */ 

/* number of times recopled because modified */ 

/* core map index for first block of core */ 

/* core map Index for last block of core */ 

/* force_write retries due to ASTE move ♦/ 

/♦ ptr to PV hold table for debugging ♦/ 



/» array of skips because wrong AST size ♦/ 

/» array of times needed each size */ 

/* count of steps taken looking for an AST entry */ 

/+ count of skips because EHS was ON ♦/ 

/♦ count of full searches made */ 

/* count of skips because pages were in core ♦/ 
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2 asktpslnlt fixed bin. 
2 acost fixed bin, 
2 asklpslock ftxed bin, 
2 asklpdius fixed bin, 

2 alaps fixed bin, 

2 updates fixed bin, 

2 setfau1ts_an fixed bin, 

2 setfau1ts_acc fixed bin, 

2 total bf fixed bin, 

2 total "bf_pf fixed bin, 

2 cpu_bf_t1me fixed bin (71), 

2 asteps (O: 3) fixed bin, 

2 ast_locked_at_t1me fixed bin (71), 

2 a8t_locked_total_tlroe fixed bin (71), 

2 ast_Iock wa1t_tlme fixed bin (71), 

2 a8t_IockTng_count fixed bin (35). 

2 c I eanup_count fixed bin, 

2 cleanups_wlth_any_rws fixed bin, 

2 cleanup_rws_count fixed bin, 

2 cleanup_real_t1ma fixed bin (71). 

/♦ PRE-PAGE METERS ♦/ 

/• 300 octal •/ 

2 tree_count (O: 63) fixed bin, 
/* 400 octal ♦/ 

2 pp_n)etera (0: 63) fixed bin, 

/* End of old cnt Include file */ 

/* 500 octal */ 

2 wusedp bit (IB) aligned, 

2 wrlte_hunts fixed bin, 

2 c1a1m_sk1p_cme fixed bin, 

2 cla1ni_sk1p_free fixed bin, 

2 clalin_notmod fixed bin, 

2 cla1ni_passed_u8ed fixed bin, 

2 cla1m_sk1p_ptw fixed bin, 

2 c1alin_wrlte8 fixed bin, 

2 clalni_8teps fixed bin, 

2 rws_reads_08 fixed bin, 

'2 pd_updates fixed bin, 

2 prB_seeks_f ailed fixed bin, 

2 pd_desperat1on_8teps fixed bin, 

2 pd_desperat1on8 fixed bin, 

2 sk1ps_nypd fixed bin, 

2 pd_wr1teahead bit (1) aligned, 

2 pd_de8peratlons_not_mod fixed bin. 



/♦ count of tiroes turned OFF Init switch */ 

/* cumulative cost of deactivations ♦/ 

/♦ count of skips because couldn't lock parent */ 

/♦ count of skips because DIUS was on •/ 

/♦ lap counter for AST list */ 

/• calls tjo updateb */ 

/* setfaults done to the entire SOW •/ 

/* setfaults done to the access field */ 

/♦ count of bound faults */ 

/* page faults during bound faults */ 

/♦ cpu time spent In bound fault ♦/ 

/♦ per-size AST step counters ♦/ 

/♦ clock reading when ast last locked */ 

/* total real time the ast lock was locked ♦/ 

/♦ total real time of all waiting on ast lock ♦/ 

/♦ number of times ast was locked ♦/ 

/* calls to pcScleanup ♦/ 

/* ditto, with >0 rws's */ 

/« total rws's started by cleanup ♦/ 

/* total real time In pc$c1eanup */ 



/* counters for pre-page decisions ♦/ 



/♦ counters for measuring pre-page success ♦/ 



/* Relative cmep to next erne for writing */ 

/♦ Times c1a1m_mod_core invoked */ 

/* Times unacceptable erne found by c_m_c */ 

/* Times free cme passed by c_m_c */ 

/* Times c_m_c passed pure page ♦/ 

/* Times used page seen ♦/ 

/* Times c_m_c saw unacceptable ptw ♦/ 

/* Writes queued by c_m_c ♦/ 

/* Steps passed In core claiming */ 

/* RWS reads outstanding. In SST for debugging ♦/ 

/* done_ time pd writes ♦/ 

/♦ counter of times quick flnd_core_ failed */ 

/* steps of allocate_pd finding pdrae ♦/ 

/* tiroes allocate_pd needed to force one free ♦/ 

/♦ flnd_core skips for nypd pages ♦/ 

/* »t"b »> al1ocate_pd at disk done time «/ 

/* desperations on pure pages */ 
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2 resurrect tons fixed b*n, 

2 volmap_seg_page_f au) ts ftxed bin (35), 

2 oopv f ixed bin, 

2 pdf )ush_rep)aces fixed bin, 

2 pcrsst_statptr ptr unal, 

2 pd_resurrect Ions ftxed bin. 

2 db)w_resurrect tons fixed bin, 

2 sgm_tlme fixed bin (71), 

2 sgm_pf fixed bin, 

2 bad_sgins fixed bin, 

2 sg[n_sgft fixed bin, 

2 good_sgtns ftxed bin. 

2 clalm_runs ftxed bin. 

2 activations fixed bin, 

2 dir_act t vat Ions fixed bin, 

2 hedge_updatevs ftxed bin, 

2 liedge_wr 1 tes fixed bin, 

2 evict_recover_data , 

3 evict_ptp bit (18) unal, 

3 evlct_phmblt bit (IB) unal, 

/♦ Data for metering force_write facility 08/19/78 ♦/ 

2 f orce_swr i tes fixed bin, 
2 f orce_pwr I tes fixed bin, 
2 fw_none fixed bin, 
2 f orce_updatevs fixed bin, 

2 pf_pd_loop_tirae fixed bin (71), 
2 pf_unloct<_pt l_t ime ftxed bin (71), 
2 pf_pd_loop_raeter ings fixed bin, 
2 pf_unlock_ptl_mGter ings fixed bin, 

2 iiial<eknown_act Ivat Ions ftxed bin (3S), 
2 bacl<up_act Ivat ions ftxed bin (35), 
2 meter ing_f lags aligned, 

3 act 1 vate_act t vated bit (1) unal, 

3 pad bit (35) unal , 
2 seg_fau1 t_cans fixed bin (35), 

/♦ METERS FOR STACK TRUNCATION ♦/ 

2 (stl<_truncate_should_didnt , 

stl<_truncate_should_dtd. 

stl<_truncate_stiouldnt_didnt , 

stl<_truncate_shouldnt_dld) fixed bin (35), 
2 stl<_pages_truncated fixed bin (35), 
2 stl<_pagBS_truncated_in_core fixed bin (35), 

2 padder (8) fixed bin, 

/* tiie following data Is used by page multilevel */ 

/♦ 600 octal ♦/ 



I* nulled addresses reinstated */ 

/» Pseudo-page faults on volmap_Beg */ 

/♦ out -of -physical -volume page faults ♦/ 

/♦ addresses "corrected" by post-crash pd flush */ 

/» ptr to damage table of pc_recover_sat */ 

/» addresses resurrected at RWS time •/ 

/« addresses resurrected by double-writing */ 

/♦ Time (UCPU) in seg mover ♦/ 

/♦ Page faults in seg moving ♦/ 

/♦ Seg moves that failed */ 

I* Seg faults In seg moves */ 

/* Seg moves that completed */ 

/* Times clalm_mod_core had to run */ 

/♦ total count of activations */ 

/* count of directory activations •/ 

/* call-in updatevs ♦/ 

/♦ call In core flush writes ♦/ 

/♦ see evict_page.alm ♦/ 

/* ptp of page being moved */ 

/♦ N/Z if page was mod */ 



/* Calls on segments to force write */ 

I* Mod pages so written */ 

/* Force write wrote none */ 

/* Updatev's so forced •/ 

/* Time looping on pd on page faults */ 

/♦ Time unlocldng ptin page faults */ 



I* activations at makeknown time */ 

/* activations for backup */ 

/* small chunks of misc. Information */ 

/* ON •> last call to activate entry actually activated something */ 

/* number calls to seg_fau1t for explicit activation */ 



/* counts */ 
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2 pdroap ptr. 

2 pdhtp ptr. 

2 pcl_«d fixed btn (8) aligned, 

2 pdsize fixed bin, 

2 pdnie_no fixed bin. 

2 pdusedp bit (18) unaligned, 

2 pd_f1r9t fixed bin. 

2 pd_inap_addr fixed bin, 

2 nrecs_pdmap fixed bin, 

2 pd_free fixed bin, 

2 pd_us1ng fixed bin, 

2 pd_wtct fixed bin. 

2 pd_wrltea fixed bin, 

2 pd_ce111ng fixed bin, 

2 pd_steps fixed bin, 

2 pd_sk1p8_lncope fixed bin, 

2 pd_sk1ps_rw8 fixed bin, 

2 pd_needed fixed bin, 

2 mod_dur1ng_wrlte fixed bin, 

2 pd_wr1te_aborta fixed bin, 

2 pd_rws_act1ve fixed bin, 

2 pd_no_free fixed bin. 

2 pd~read_truncates fixed bin, 

2 pd wrlte_truncate8 fixed bin, 

2 pd^htslze fixed bin, 

2 pd_hash_inask bit (IB), 

2 pd(iiap_astep ptr, 

2 zero_page8 fixed bin. 

2 pd_zero_page8 fixed bin, 

2 trace_sw a1 Igned. 

3 pad_trace bit (32) unaligned, 

3 pc_trace pf bit (1) unaligned. 

3 tty_trace bit (1) unaligned. 

3 pc_trace bit (1) unaligned. 

3 sc_trace bit (1) unaligned. 
2 new_pages fixed bin, 
2 rws_t1me_temp fixed bin (71), 
2 rws_tlnie_atart fixed bin (71). 
2 rws_tlme_done fixed bin (71), 
2 pd tlme_counts (4) fixed bin, 
2 pd"t1ine_va1ue8 (4) fixed bin (71), 
2 pd no_free_gtpd fixed bin. 
2 pd~page_faul ts fixed bin. 
2 pd~no_rree_f Irat fixed bin, 
2 update_lndex fixed bin. 
2 last_update fixed bin (71), 
2 count_pdme3 fixed bin, 
2 bucket_overf low fixed bin, 
2 buckets (0:63) fixed bin, 
2 ast_track bit (1) aligned, 
2 d1rlock_wr1tebehlnd fixed bin. 
2 wr1te_llm1t fixed bin, 
2 pad4 ( 1) fixed bin; 

/* END INCLUDE FILE sst.lncl.p11 ♦/ 



/♦ pointer to the pd map */ 

/♦ pointer to the pd hash table */ 

/* pvt Index of paging device, O If none ♦/ 

/♦ the number of words In a paging device map entry */ 

/♦ the number of entries In the paging device map */ 

/♦ pointer to head of paging device used Hat */ 

/* first usable record of paging device */ 

/* core addresg of base of paging device map */ 

/♦ number of records In pd map */ 

/♦ number of free records on the paging device */ 

/* actual number of pd records being used ♦/ 

/♦ number of read/write sequences queued */ 

/* total number of read/write sequences ever made «/ 

/* number of times too many rws active at once */ 

/* total steps taken around the pd map */ 

/♦ number of entries skipped because page was In core */ 

/* number of entries skipped because a rws was active */ 

/* total number of pd records needed ♦/ 

/* times a page was modified while It was being written */ 

/♦ number of pd writes aborted */ 

/* count of current number of active rws's */ 

/* number of times couldn't find a free pd record ♦/ 

/♦ number of truncated pages during read of rws ♦/ 

/* number of truncated pages during write of rws ♦/ 

/* number of entries In pd hash table */ 

/♦ mask used In pd hashing algorithm ♦/ 

/* pointer to temporary segment for pdmap copying ♦/ 

/♦ count of pages truncated because all zero */ 

/• as above except also on paging device */ 

/♦ trlaclng control flags */ 

/♦ tracing for page faults, done, etc. */ 

/* flag used by page control primitives ♦/ 

/* flag used by segment control primitives */ 

/* newly created pages ♦/ 

/* temporary used for rws metering */ 

/* time spent Initiating rws ♦/ 

/♦ time spent finishing up rws */ 

/♦ number of hits In the following bins */ 

/* total residency time for the 4 bins */ 

/♦ times pages written to disk because gtpd ON */ 

/♦ total page faults from pd */ 

/♦ times pages were written to disk because first write ♦/ 

/* temporary used during paging device map update »/ 

/* time last paging device update was performed */ 

/* If non-zero, pdrae statistics will be kept */ 

/♦ counter for overflows ♦/ 

/♦ buckets for pdme stats */ 

/♦ "1''b •> keep SST name table ♦/ 

/* "1 to flush modified dlr pages In lock$unlock ♦/ 

/* Max H of outstanding writes by page control */ 

/* padding to 512 words (1000)8 */ 
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sstnt . incl pi 1 segment In: >ldd> Include contents modified: 11/01/79 1033.0 

entry iiiodined: O3/10/82 0836.7 



/♦ Begin Include file sstnt . Incl .pi I */ 

/♦ Created 10/03/74 by Bernard Greenberg ♦/ 

/♦ modified 08/24/79 by J. A. Bush for easier calculation of size of sstnt ♦/ 

del sst_naraes_$ ext; /♦ Segment containing sst name table */ 

del sstnp ptr; /♦ Pointer to sst name segment ♦/ 

del I sstnt based (sstnp) aligned. /* Major structure */ 

2 valid bit (1) aligned, /♦ < => structure filled by Multics •/ 

2 mul t lcs_or_bos char (4) aligned, /* Origin of data in table */ 

2 nentries fixed bin. /» number of entries In the sstnt ♦/ 
2 padi (5) fixed bin, 

2 (ast_slzes. /♦ Sizes of ASTE's at each level ♦/ 

ast_narne_of fsets, /♦ Starting Index for names at each level ♦/ 

ast_offsets. /* Starting rel addr of each AST region ♦/ 
pad2) (O : 3) fixed bin, 

2 names (O : refer (sstnt .nentrtes) ) char (32) varying; /» Names of AST entries */ 

del (sstnmx, ptsi_a) fixed bin (17); /♦ indax Into name table »/ 

del nm_astep ptr; /♦ astep to be used */ 

/♦ End Include file sstnt . Incl .pi 1 ♦/ 
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stack O data. IncI .p11 



segment In: 
entry modified: 



>1dd> Include 
03/10/82 0836. 



contents modified: 10/03/79 1601.4 



/• EJEGIN INCLUDE FILE ... 8tack_0_data. IncI .pi 1 •/ 

/* Created 790509 by Mike Grady */ 

dgl stack_0_data$ fixed tain ext; 

del stack_0_data_lnlt_nuniber_of_8tacks fixed bin; 

del sdtp ptr; 

del 1 sdt aligned based (sdtp), 
2 lock bit (36). 
2 num_stacks fixed bin. 
2 freep bit (18), 
2 pad fixed bin, 

2 stacks (stack 0_data_lnlt nuniber_of_8tackB 
refer (8dt.num_8tacks7) like sdte; 

del sdtep ptr; 

del I sdte aligned based (sdtep). 
2 nextp bit (18) unal , 
2 pad bit (18) unal , 
2 astep bit (IS) unal , 
2 aptep bit ( 18) unal , 
2 sdw bit (72): 



/* shared stack O data base seg */ 
/♦ Make PL/I work */ 



/♦ stack O database */ 

/* lock before changing threads ♦/ 

/♦ number of stacks In pool */ 

/* head of free thread, managed LIFO ♦/ 



/* stack data table entry ♦/ 

/♦ thread to next free entry (If free) ♦/ 

/* ptr to ASTE for this stack seg •/ 

/* pth to APTE of process using this stack, if not free ♦/ 

/* SDW for this stack seg */ 



/* END INCLUDE FILE 



stack_0_dBta. IncI .pi I */ 
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stackf rame. Incl .pi 1 



segment tn: 

entry modified: 



> ) dd> ( nc 1 ud© 
03/10/82 0836.6 



contents modified: 04/13/78 M56. 1 



/• 



BEGIN INCLUDE FILE 



. stack_f raroo. incl .pi 1 



»/ 



/* Modified: 16 Dec 1977. D. Levin - to add fio_ps_ptr and pi 1_pa_ptr ♦/. 

/♦ Modified: 3 Feb 1978, P. Krupp - to add rununl tmanager bit & rnainproc bit ♦/ 

/♦ Modified: 21 March 1978, 0. Levin - change fio_ps_ptr to Bupport__ptr */ 



del sp pointer; 

del stack_f ranie_raln_length fixed bin static inlt(4e); 



/• pointer to beginning of stack frame */ 



del 1 stack_frame based(sp) aligned, 
2 pointer_registers(0 : 7) ptr, 
2 prev_sp pointer, 
2 next_sp pointer, 
2 return_ptr pointer, 
2 entry_ptr pointer, 
2 operator_and_lp_ptr ptr. 
2 arg_ptr pointer. 
2 statlc_ptr ptr unaligned, 

2 support_ptr ptr unal . ,/♦ only used by fortran I/O */ 
2 on_unl t_relp1 bit(l8) unaligned. 
2 on_unit_relp2 b1t(18) unaligned,' 
2 translator_ld bit! 18) unaligned. 



2 operator_return_of f set bit(18) unaligned, 

2 x(0: 7) bit(ia) unaligned, 

2 a blt(36) , 

2 q bit(36), 

2 e bit(36). 

2 timer bit(27) unaligned, 

2 pad bit (6) unaligned, 

2 ring_alarm_reg bltO) unaligned; 



/t serves as both */ 



/* Transilator ID 

«> PL/I version U 

1 => ALM 

2 "> PL/I version i 

3 °> signal caller frame 

4 '> signaller frame ♦/ 

/♦ Index registers ♦/ 
/♦ accumulator */ 
/+ q-register */ 
/* exponent */ 

/♦ timer ♦/ 



del 1 stack_f rame_f lags based(sp) aligned, 
2 pad(0 : 7) b1t(72), 
2 xxO bit(22) unal , 
2 ma i n_proc b i t ( 1 ) una 1 , 
2 run_un i t_manager bit(1) unal, 
2 signal bl t( 1 ) unal , 
2 erawl_out blt(1) unal, 
2 signaller bit(1) unal, 
2 Hnk_trap bit(l) unal. 
2 support bit(t) unal. 



/♦ skip oyer prs ♦/ 



/* on 1 

/♦ on i 

/♦ on 1 

/+ on i 

/* on i 

/* on I 

/* on I 



frame belongs to a main procedure */ 
frame belongs to run unit manager ♦/ 
frame belongs to logical signal_ ♦/ 
this is a signal caller frame ♦/ 
next frame is signaller's ♦/ 
this frame was made by the linker */ 
frame belongs to a support proc */ 
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2 cond » 1 1 on b 1 1 ( 1 ) una I , 

2 xxOa bH(6) una I , 

2 xxl fixed bin, 

2 xx2 fixed bin, 

2 xx3 blt(25) unal , 

2 old crawJ_out bit (O unal, 

2 old~slgnaTler b1t(1) unal, 

2 xx3a b1t(9) unaligned, 

2 xx4(9) b1t(72) aligned, 

2 v2_p1 1_op_ret_base ptr. 



/♦ 



2 xx5 b1t(72) aligned. 
2 pi 1__ps_ptr ptr; 

END INCLUDE FILE 



/* on If condition established In this frame •/ 



/♦ on If this Is a signal caller frame */ 
/• on If next frame Is signaller's */ 

/* When a V2 PL/I program calls an operator the 

♦ operator puts a pointer to the base of 

• the calling procedure here, (text base ptr) ♦/ 

/* ptr to ps for this frame: also used by flo. */ 



stack frame. Incl .pi 1 */ 
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stack_header . inci .pi 1 



segment in: 

entry modified: 



> I dd> i nc I ude 

03/10/82 0836.6 



contents mod if ted: 04/13/78 1156.1 



/♦ BEGIN INCLUDE FILE ... stack_header . incl .pH .. 3/72 Bill SHver */ 

/* modified 7/76 by M. Weaver for ^system links and more system use of areas ♦/ 

/♦ modified 3/77 by M. Weaver to add rnt_ptr */ 



del 



sb 



ptr ; 



del 1 stack header 



based (sb) aligned, 



2 padi (4) fixed bin, 

2 old^lot_ptr ptr, 
2 comblned_stat_ptr ptr, 

2 clr_ptr ptr. 

2 max_lot_s1ze fixed bin(17) unal, 
2 ma in_proc_ Invoked fixed bin (11) unal, 
2 run_unit_depth fixed bin(5) unal, 
2 cur_lot_slze fixed b1n(17) unal. 

2 system_f ree_ptr ptr, 
2 user_f ree_ptr ptr, 

2 null_ptr ptr, 

2 stack_beg1n_ptr ptr, 

2 stack_end_ptr ptr, 

2 lot_ptr ptr, 

2 stgnal_ptr ptr, 
2 bar_mode_sp ptr, 
2 pi 1_operators_ptr ptr, 
2 call_op_ptr ptr, 

2 push_op_ptr ptr, 
2 return_op_ptr ptr, 
2 return_no_pop_op_ptr ptr, 
2 entry_op_ptr ptr, 

2 trans_op_tv_ptr ptr. 

2 isot_ptr ptr. 

2 sct_ptr ptr. 

2 unw1nder_ptr ptr, 

2 sys_l ink_inf o_ptr ptr, 

2 rnt_ptr ptr. 

2 ect_ptr ptr, 

2 assign_l 1nkage_ptr ptr. 

2 pad3 (8)' bit (36) aligned; 



/♦ 


(O) 


/♦ 


(4) 


/♦ 


(6) 


/* 


(8) 


/♦ 


(10) 


/♦ 


(10) 


/• 


(10) 


/♦ 


(11) 


/* 


(12) 


/* 


(14) 


/* 


(16) 


/♦ 


(18) 


/♦ 


(20) 


/♦ 


(22) 


/* 


(24) 


/♦ 


(26) 


/* 


(28) 


/* 


(30) 


/* 


(32) 


/♦ 


(34) 


/♦ 


(36) 


/* 


(38) 


/♦ 


(40) 


/* 


(42) 


/* 


(44) 


/♦ 


(46) 


/* 


(48) 


/♦ 


(50) 


/» 


(52) 


/» 


(54) 


/* 


(56) 



/• tile main pointer to tlie stack header */ 



(O) also used as arg list by outward_cal l_handler ♦/ 
pointer to the lot for current ring (obsolete) •/ 
pointer to area containing separate static */ 

pointer to area containing linkage sections */ 
OU number of words allowed in lot */ 
OL nonzero if main procedure invoked in run unit */ 
PL number of active run units stacked */ 
number of words (entries) in lot ♦/ 

pointer to system storage area */ 
pointer to user storage area */ 

♦/ 

pointer to first stack frame on the stack */ 

pointer to next useable stack frame */ 

pointer to the lot for the current ring ♦/ 

pointer to signal procedure for current ring */ 
value of sp before entering bar mode */ 
pointer to pi 1_operators_$operator_table •/ 
pointer to standard call operator */ . 

pointer to standard push operator */ 
pointer to standard return operator ♦/ 
pointer to standard return / no pop operator */ 
pointer to standard entry operator ♦/ 

pointer to translator operator ptrs */ 
pointer to ISOT ♦/ 

pointer to System Condition Table*/ 
pointer to unwinder for current ring •/ 

pointer to *system link name table */ 

pointer to Reference Name Table */ 

pointer to event channel table */ 

pointer to storage for (obsolete) hcs_$assign_l inkage */ 

for future expansion ♦/ 
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/♦ Tha following offset refers to a table within the pll operator table. ♦/ 

del tv offset fixed bin InltOSl) Internal static; /♦ (551) octal ♦/ 



♦/ 



/♦ The followlno constants are offsets within this transfer vector table. 

del (call offset fixed bin lnlt(271). 

push"off8et fixed bin 1nlt(272). 

return offset fixed bin ln1t(273). 
return~no pop offset fixed bin lnlt(274), 
entry_offset ~ fixed bin lnlt(275)) Internal static; 



/* The following declaration Is an overlay of the whole stack header. Procedures which 
move the whole stack header should use this overlay. 

*/ 

del stack_header_overlay (slze(stack_header ) ) fixed bin based (sb); 
/« END INCLUDE FILE ... 8tack_header . incl .pi 1 ♦/ 
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stpck_seg. incl .pi t 



segment (n; >ldd>(nclude 

entry modi f (ed: 10/13/82 1311.9 



contents modified: 10/13/82 1310.8 



/♦ START OF: 

del 
del 
del 
del 



stock_seg. inci .pt 1 



del 
del 
del 



stock_segp 
reeord_stoekp 
vtoce_stockp 
stock_seg$ 

n_ln_record_stoek 
n_vo I map_pagas 
n In vtoce stock 



ptr; 




ptr; 




ptr; 




ext; 




fixed 


bin: 


fixed 


bin; 


f 1 xed 


bin; 



♦/ 



del 



1 stock_seo 
2 meters 



aligned based (stock_segp) , 



aligned like rsmeters. 



2 record_stock_entr les fixed bin, 
2 vtoce_Btock_entr les fixed bin, 
2 record_stock_size fixed bin, 
2 vtoce_8tock__8ize fixed bin, 
2 n_stock_entr les fixed bin, 
2 record_stock_arrayp ptr, 
2 vtoce_stock_arrayp ptr; 



/♦ Number of entries in a record stock */ 

i* Numbor of entries in a VTOCE stock */ 

/* Size of a record stock in words */ 

/» Size of a VTOCE stock in words »/ 

/♦ Numbcsr of stocks of each type */ 

/* Record stock region ♦/ 

/♦ VTOCt; stock region ♦/ 



del I record_stock 

2 pvtep 

2 n_ln_stock 

2 n_volmap_pages 

2 n_f ree_1n_stock 
2 n_os_in_8tock 

2 low_thresiiold 
2 h1gh_thresho1d 

2 target 

2 stock_offset 

2 n_words_in_sitock 
2 searcii_ index 

2 old_volmap_page 
3 last 
3 pad 

2 volmap_page 



aligned based (reeord_stockp) , 

ptr una!, /* PVTE for tills stock ♦/ 

fixed bin (18) uns unal,/* Max number of addresses in stock */ 

fixed bin (18) uns una1,/'» Number of pages In Volume Map */ • 

fixed bin (18) uns unal./* Number addresses currently free */ 

fixed bin (IB) uns una!,/* Number addresses currently out-of -service ♦/ 

fixed bin (18) uns unal,/* Low threshold for withdrawing from volmap */ 

fixed bin (18) uns unal./* High threshold for depositing to volmap ♦/ 

fixed bin (IB) uns unal,/* Target for stock */ 

bit (IB) unal. /* Offset of stock In this structure ♦/ 

fixed bin (18) uns unal,/* Number of words = Number of entries / 2 */ 

fixed bin (18) uns unal,/* Roving pointer */ 

(3) aligned. /♦ N_OLD_VOiMAP_ PAGES (cif) ♦/ 

fixed bin (18) uns unal,/* Roving pointer ♦/ 
bit ( 18) unal , 

(n_volmap_pagas refer (record_stock .n_volmap_pages) ) aligned, 
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3 n_free 
3 baseadd 

2 stock 



fixed bin (18) uns unal./* Number free records In th«8 volmap page */ 
f»xed bin (17) unal. /♦ First record address described by this page ♦/ 

(n_1n_record_stock refer (record_stock.n_ln_8tock) ) bit (18) una); /* Stock array of addresses * 

/* bit O ON => out-of -service */ . 



del 


1 


vtoce_8tock 

2 pvtep 

2 n_1n_Btock 

2 nIfree_ln_8tock 

2 target 

2 8earch_lndex 

2 stock 


ndlces ♦/ 






del 


1 


rsmeters 



aligned based (vtoce stockp). 

ptr unal. /* PVTE for this stock */ 

fixed bin (18) uns unal,/* Max number Indices In stock */ 

fixed bin (18) uns unal./* Number Indices currently free */ 

fixed bin (18) uns unal./* Target when withdrawing/depositing •/ 

fixed bin (18) uns unal./* Roving pointer */ , „ . . wTnr.c t 

(n_ln_vtoce_stock refer (vtoce.stock .n_ln_8tock) ) fixed bin (17) unal: /.Stock array of VTOCE 1 



al tgned based. 



2 async_read_caH8 fixed bin (35), 
2 async_page_reads fixed bin (35), 
2 async po8t_lo_cal is fixed bin (35). 
2 deposTt_can8 fixed bin (35), 
2 async_po8t_la_tlrae fixed bin (71), 
2 deposit time fixed bin (71), 
2 1ow_thresh_detected fixed tain (35), 
2 high thresh_detected fixed bin (35), 
2 low_thresh_fal1s fixed bin (35), 
2 wlthdraw_8tock_steps fixed bin (35), 
2 wlthdraw_stock_loBBes fixed bin (35), 
2 n_wlthdraw_at tempt fixed bin (35), 
2 n_wlthdraw_range fixed bin (35), 
2 nj)ages_wlthdraw_stock fixed bin (35), 
2 n_pages_wlthdraw_async fixed bin (35), 
2 n_v_w1thdraw_atteropt8 fixed bin (35). 
2 withdraw volroap_step8 fixed bin (35). 
2 depo8lt_itock_steps fixed bin (35), 
2 deposlt_stock_losse8 fixed bin (35). 
2 n_deposlt_at tempt fixed bin (35), 
2 n_pageB_depos1t_8tock fixed bin (35), 
2 n_pages_deposl t_volmap fixed bin (35), 
2 n V depos1t_at tempts fixed bin (35), 



reset_os_ca1 Is 
reset_os_losses 
wlthdraw_ca1 Is 
wlthdraw_t tme 
pc_depos I t_t I me 
pc_depos 1 t_ca 1 1 s 
pc_depos 1 t_pages 



fixed bin (35). 
fixed bin (35), 
fixed bin (35). 
fixed bin (71). 
fixed bin (71). 
fixed bin (35). 
fixed bin (35). 



get_f ree_vtoce_ca1 is fixed bin (35). 

return_free_vtoce_ca11 fixed bin (35), 
2 deposl7_V8tock_cal is fixed bin (35), 
2 deposlt_v8tock_fall8 fixed bin (35), 
2 withdraw vstock calls fixed bin (35), 



/* Number of asynchronous read attempts */ 

/* Number of times page read was required ♦/ 

/• Number of times read or write posted */ 

/♦ Number of times deposit called */ 

/♦ CPU time posting I/Os (interrupt side) */ 

/* CPU time In deposit (call side) */ 

/♦ Number of times stock below low threshold •/ 

/* Number of times stock above high threshold */ 

/* Number of times no records in volmap */ 

/* Number steps thru stock In withdraw */ 

/* Number lock less losses */ 

/* Number attempts to withdraw a page */ 

/* Number attempts to withdraw within range */ 

/» Number pages withdrawn from stock */ 

/• Number pages withdrawn from volmap ♦/ 

/* Number attempts to withdraw from volmap */ 

/* Number steps thru volmap in withdraw */ 

/* Number steps thru stock In deposit */ 

/* Number lock less losses «/ 

/♦ Number attempts to deposit a page */ 

/♦ Number pages deposited to stock */ 

/* Number pages deposited to volmap */ 

/* Number attempts to deposit to volmap ♦/ 

/* Number calls to reset_08 */ 

/* Number lockless losses */ 

/* Number calls to withdraw */ 

/* CPU time In withdraw (page-fault) ♦/ 

/♦ CPU time In po_depos1t */ 

/♦ Number calls to pc_depos1t */ 

/* Number pages deposited by pc_deposlt */ 

/* Number calls to get_f ree_vtoce ♦/ 

/* Number calls to return_f ree_vtoce ♦/ 

/* Number attempts to deposit to vtoce stock */ 

/• Number times deposit failed ♦/ 

/* Number attempts to withdraw from vtoce stock */ 
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2 w( thdraw_vstock_fans fixed bin (35). 
2 depos J t_vtoc_iiiap fixed bin (35), 
2 w( thdraw_ch8ck_scav fixed bin (35). 
2 Ml thdraw_conf I ict fixed bin (35). 
2 pad (tt) fixed bin (35): 



I* Number times withdraw failed */ 

/♦ Number times vtoce deposited to map */ 

/♦ Number times withdraw checked an address for scavenge */ 

/♦ Number times conflict found ♦/ 



del N_OLD_VOLMAP_PAGES fixed bin inlt (3) int static options (constant); 

del DEFAULT_N_IN_RECORO_STOCK fixed bin init (104) int static options (constant); 

del OEFAULT_N_IN_VTOCE_STOCK fixed bin Inlt (10) int static options (constant): 



END OF: 



stock_seg. inc) .pi 1 



*/ 
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str. (ncl .pi 1 



segment <n: > I dol> < nc 1 ude 

entr/ modified: 03/10/82 0836.4 



contents modified: 04/02/70 1914.7 



/* BEGIN INCLUDE FILE ... str.lncl.pll ... last modified March 1970 ♦/ 



del 5tr_aeg$ ext. 
strp ptr: 

del 1 str based (strp) aligned, 

(2 fp bit (18), 
2 bp bit (18), 

2 segno bit ( IB). 

2 dstep bit (18)) unaligned; 

del stra (0:8000) bit (72) based (strp) aligned; 

/• END INCLUDE FILE ... str.lncl.pll */ 



/♦ segment or process trailer declaration */ 

/♦forward ast trailer rel pointer */ 
/♦ backward ast trailer rel pointer*/ 

/♦ segment number*/ 

/* rel pointer to ring O dste ♦/ 
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tc_data.cds segment in: >lcld>hard>source system Id: ,37-15 

contents modi f*ed: 01/26/83 1347. t entry modified; 03/27/83 1807.2 

* Copyright, (C) Honeywell Information Systems Inc., 1982 * 

♦ * • . 
**************** **it'* **************************** **^ ** ****** */ ■ ■ 

/* TC_DATA - This Is the Traffic Controller Database. ♦/ 
/* Last modified (Date and reason): 
2/&/16 by S. Webber Initial coding 
6/20/79 by Mil<e Grady to inlt max_maxe 
3/4/Bt by J. Bonglovannl not to set prds_length (it's done from the header 

or the TBLS Conflg Card) 
3/21/Bl by J. Bonglovannl for max_stopped_stact<_0, tni t lal Izat loin NTO, 

response time metering ' . 

6/27/81 by d. Bonglovannl for tuning parameter changes (-tcpu, +|ore_eropt_8ample_t Irae, 

gp_at_notlfy and Qp_at_pt Inot If y off by default 
1/82 BIM for stk truncation tuning parms. 
4/27/82 by J. Bonglovannl to change po8t_purge to OFF 
August 1982, J. Bonglovannl, for realtiine_lo parameters 
♦/ 

/* ****************************************************** 

* * 

* * 

* Copyright (c) 1972 by Massachusetts Institute of * 

• Technology and Honeywell Information Systems. Inc. * . 

♦ » 

♦ * 
****************************************************** «/ 

tcdata: proc; 

/♦ This program creates the tc_data base */ 

/* Automatic •/ 

del 1 cdsa aligned like cds_args; 
del code fixed bin (35); 
del bigtime fixed bin (71); 

/♦ Based ♦/ 

del 1 tc_data aligned like tern based (temp); 

/♦ Static +/ 

del exclude_pad (1) char (32) aligned static options (constant) init ("pad*"); 

/* Builtlns */ 



include.**, hard. source tc_data.cds. Page 108 

F80A - Not to be reproduced 



del (addr. bin, null, rel. size, string, unspec) buHtln;: 
/♦ Entries ♦/ 

del com_arr_ entry options (variable); 

del create_data_8egn>ent_ entry (ptr,, fixed bin (35)>; 

del get_temp_aegment_ entry (char (*), ptr. fixed bin (35)); 

del release_teiiip_segroent_ entry (char (*), ptr, fixed bin (35)); 
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call gat_temp_segroent_ ("tc_data". temp, code); 

/» Check offsets assumed by BOS ♦/ 

call check_of f sat_for_bos (addr ( tc_data.apt_of f set ) . I'M. "apt_of f set " ) ; 

call check_offset_for_bos (addr ( tc_data.apt_sizo) , 203, "apt_sl2e"); 

call check of f set_f or_bos (addr ( tG_data.apt_entry_s tze) . 215, "apt_entry_slze" ) ; 



/♦ -1 = unlocked ♦/ 
/♦ O » locked ♦/ 



tc_data.apt_of f set = rel (addr ( tcdata. apt ) ) ; 
tc_data. apt_lock >= -1; 
tc_data.meterlng._lock = -1; 
tc_data-. work lna_set_f actor = 1; 
tc_data.ncpu « O; 
tcdata'. ltt_slza » 15b; 
tc_data.dst_slze = 155; 
tc_data. lnltlanzer_ld = (36)"1"b; 
tc_data.raax_el Iglble = 6*262144; 
tc_data.roax_(nax_eHglble = 16*262144; 
tc_data.max_3topped_stack_0 = 4; 
tc_data.apt_entry_stze = size (apte); 
tc_data.pds_length = 1024; 

tc_data. Interact 1ve_q.fp = rel (addr ( tc_data. Interact lve_q) ) ; 
tc_data. Interact1ve_q.bp =■ rel (addr ( tc~data. Interact lve_q) ) ; 
tc_data. Interact ive_q. sent Inel « (36)"l"b; 



tc_data.max_hproo_6egno » 191; 
tc_data.dst_ptr = null; 
tc_data.old_user = null; 
tcdata. taf Irst = 2000000; 
tcdata. telast = 2O00O00; 
tc_data. t imax = 8000000; 

tc_data.process_lnl t tal_quantum - 2000000; 
tc_data.gp_at_not 1 f y = O; 
tc_data.gp_at_ptlnot If y » O; 
tc_data.pre_empt_sarapla_t Ime = 40000; 
tc_data.max_t imar_reglster » 40000; 



/* largest (default) hardcore segment number */ 



/♦ off by default +/ 
/* off by defaul t ♦/ 
/» 40 milliseconds ♦/ 



tc_data. sort_to_olhead =1; 
tc_data.auto_tune_ws = 1; 
tc_data.ocore = .Olb; 
tc_data. stk_truncate = "l"b; 
tc_data . stk_truncate_always = "0"b; 

/♦ See fast_hc_(pc. but the rolling average of steps/block Is- calculated */ 
/* as NEW_AVERAGE = factor ♦NEW_VALU£ + ( 1-f actor ) *OLD_AVERAGE •/ 

tc_data.stk_trunc_avg_f 1 = 0.9375; /♦ 15/16 ♦/ 

tc_data. stk_trunc_avg_f 2 = lb - tc_data. stk_trunc_avg_f 1 ; 

tc_data. lock_error_sever 1 ty = 3; /♦ BEEP BEEP but no crash ♦/ 
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tc_clata.realt<ino_q.fp • rel (addr ( tc_data. real 1: lnie_q) ) ; 
tc_data.realt*me_q.bp « rel (addr ( tc_data. real 1: lmo_q) ) : 
tc_datti.rea1tlnie~q. sentinel » (36)"«"b: 

tc_data.el »glble_q_head.fp • rel (addr ( tc_data.el lglble_q_tal 1 ) ) ; 
tc data.eHglble_q_head.bp ■ "0"b; 
tc2data.eHolble_q_head. sentinel « C36)"1"b; 

tc_data.el lglblo_q_tall .fp « rel (addr ( tc_data, ldle_tal 1 ) ) ; 
tc_data.el Iglble q tatl.bp - rel (addr ( tc_data.Bl lgltale_q_head) ) i 
tc_datB.eHo1ble3q~tall. sentinel ■ (36)"l"b; 



tc_data. Idle. 
tc_data. Idle, 
tc data. Idle 



tall.fp ' "0"b: 

tall.bp = rel (addr ( tc_data.el lglble_q_tal I ) ) ; 
"tall. sentinel « (36)"l"b: 



tc_data.mln_el Igtble - 2*262144; 
tc_data.guaranteed_el lg_lnc » 250000; 
tc_data.prlorlty_sched_lnc ■ aooooooO: 
tc_data. 1nt_q_enabled ■ 1; 
tc_data.fnp_buffer_threshold " 30; 



/* fnp tries to keep > this many free buff */ 



unspec (blg_tline) - -OOOOOpOOOOOOOOOOOOOOl 1 1 1 1 1 1 11 11 1 1 1 11 11 1 1 11 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 11 1 1 1 1 11 "b; 

tc_data.end of_tlnie » blg_tlrae; 

tc_data.next_alarin_tlrae ■ blg_tlrne; /♦ gets zeroed by tc_lnl t$part_2 */ 

tc_data.pr loFlty_BChed_tlnie « b(g_tlme; 

tc_data. tty_pol Hng_tlme • bJg_tlrne; 

tc_data.dl3k_poll lng_tlme » blg_tline: 

tc_data.tape_po,lHng_tlme ■ blg_tline; 

tc^data. lmp_poH 1ng_tlme ■» blg_tline; 

tc_data.mo8_pol 1 1ng_tlme - blg_tlme; 

tc_data.volinap_po11 lng_tlme » blg_tlnie; 

tc_data.realtinie lo_deadllne • 0; 

tc_data.realtlme~lo_quantuni - 5000; /* 5 milliseconds */ 

tc_data.max_channel8 "6; 

tc_data. lnlt_walt_tlmeout - 5000000: /* 5 second NTO during Initialization 

tc_data. lnlt~tlmeout_severltv " O; /* beep 

tc_data.vcpu~responsB_bounds_8lze ■ VCPU_RESPON!;e_BOUNDS; 
tc_data.vcpu~response_bounds~( 1) • 500000; /* 1/2 second 
tc_data.vcpu2response_bounds (2) ■ 1O00O00; /♦ 1 second 
tc_data.vcpu~response_bounds (3) ■ 10000000; /* 10 seconds 



♦/ 
*/ 

•/ 
♦/ 
*/ 



tc_data.defaul t_procs_requ1red = 
/* Now set up call to create data base */ 



(8) "1"b: 



cdsa. sect ions (1).p ■ addr (tc_data); 
cdsa. sections (1).len " size (tc_data); 
cdsa. sect Ions ( 1 ) .struct_name = "tc_data"; 

cdsa. seg_name = "tc_data"; 
cdsa . num_exc 1 ude_naTOes = 1 ; 
c:dsa.exclude_array_ptr • addr (exclude_pad) ; 



/♦ a1 I CPUs ♦/ 
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string (cdsa. switches ) = "0"b; 
cdsa. switches. have_text = "l"b; 

call create_data_segment_ (addr (cdsa), code); 

call release_temp_segraent_ ("tc_data", temp, code); 
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check_of f set_f or_b08 : 

proc (Ttem_ptr, bos_offset, ltem_name): 

del lteiii_ptr ptr; 

del bos_offset fixed bin (18); 

del Item name char (*); 



/* pointer to Item In tc_data 
/♦ location assumed by BOS 
/* name of Item In structure 



•/ 
*/ 
•/ 



If bin (rel (ltem_ptr)) "■ bos_offset 

then call com_err_ (O. -tc_data". "-^a not at BOS-assumed offset ( d= oo)", 
ltem_name, bos_of7set, bos_offset); 



end check offset for bos; 
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% Include cds_args; 
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% include apte: 
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% tnclude tcm; 

end tc_data; 
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tern. inci .pi t 



segment in: 
entry inodf f led: 



> 1 dd> I nc 1 ude 
10/27/82 1226.4 



contents modified: 10/27/82 1226.2 



/* BEGIN INCLUDE FILE ... tcm.lnc1.p11 ... used to generate tc_data cds ♦/ 

/* NOTE -- This include file has TWO counterparts In ALU: tc_meters. Inci .aim and ♦/ 

/• wcte Incl.alm. They cannot be produced with elf. and must be kept up to date manually. 



♦/ 



del temp ptr; 

del 1 tcro aligned based (temp), 

2 pad_base (3) fixed bin (18). 

2 cld2 fixed bin ( 18). 

2 c1d3 fixed bin ( 18). 

2 c1d4 fixed bin ( 18). 

2 depth count fixed bin (18). 

2 loadings fixed bin (IB), 

2 blocks fixed bin (18), 
2 wakeups fixed bin (18). 
2 waits fixed bin ( 18), 
2 notifies fixed bin (18), 
2 schedullngs fixed bin (18), 
2 Interactions fixed bin (18), 
2 avequeue fixed bin (35. 18). 
2 te_wa1t fixed bin (18), 

2 te_block fixed bin (18). 

2 te_1_stop fixed bin (18), 

2 te_pra_empt fixed bin (18), 

2 p Interactions fixed bin, 

2 idle fixed bin (71), 

2 mp_1dle fixed bin (71), 

2 nmp_1d1e f Ixed bin (71 ) , 
2 zero_ldle fixed bin (71). 
2 last_t1me fixed bin (71). 
2 loop_lock8 fixed bin (18), 
2 loop_lock_t1me fixed bin (18). 
2 ave_e11glble fixed bin (35, 18), 
2 sort_to_elhead fixed bin (18), 
2 proeessar_t1me fixed bin (71), 
2 response_tlroe fixed bin (71). 
2 el 1g1ble_tlnie fixed bin (71), 
2 response_count fixed bin, 
2 el lglble_count fixed bin, 
2 qu1t_eounts (0:5) fixed bin. 
2 loadlng_ldle fixed bin (71). 
2 de1ta_vcpu fixed bin (71), 
2 post_purge_swltch fixed bin. 
2 t lme~out_Beverity fixed bin. 



/• Stat moved from here 



*/ 



/* depth last process run */ 

/♦ number of process loadings */ 

/• number of calls to block */ 
/* number of calls to wakeup ♦/ 
/* number of calls to wait */ 
/* number of calls to notify */ 

/* number of Interactive schedullngs */ 

/* recent time average of number In queue ♦/ 

/♦ times te called from wait */ 

/* times te updated from block ♦/ 

/* times te updated from 1_stop */ 

/* times te updated from pre_empt */ . 

/♦ times Interaction bit turned off because of high priority ♦/ 

/* total Idle time ♦/ 

/* mul tl -programming Idle */ 

/* non-mult 1 -programming Idle time */ 

/* zero Idle time */ 

/» last time a process was run */ 

/• tiroes looped on the APT lock */ 

/♦ time looping on the APT lock •/ 

/* average length of eligible queue */ 

/* 0«> no one.l ■> Int've only, 2 «> everybody */ 

/♦ total processor time on system */ 

/* estimate of response time ♦/ 

/♦ estimate of eligible time */ 

/* count of response meters */ 

/» count of eligible meters */ 

/* array of buckets indexed by state */ 

/* loadlng_ldle time ♦/ 

/* delta virtual CPU time for the system */ 

/♦ON If post purging is to be done •/ 

/* syserr first arg for notify time outs ♦/ 
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2 notlfy_check fixed bin. 

2 qui t_pr lor t ty fixed bin, 

2 1obin_pon lng_tlme fixed bin (71). 

2 end_of_tline fixed bin (71), 

2 gp_at_notlfy fixed bin (18), 

2 gp_at_ptlnot1fy fixed bin (18). 

2 lnt_q_enabled fixed bin (18), 

2 fnp_buf fer_threshold fixed bin (IB), 



/♦ 100 octal */ 

2 depths (8) fixed bin (IB), 
2 tdepths (8) fixed bin (71), 
2 pfdepth (a) fixed bin (18), 

2 pt l_not_walts fixed bin (18), 

2 gw_gp_wlndow_count fixed bin (18), 

2 meter1ng_1ock fixed bin (18), 

2 ptl_walts fixed bin (18), 

2 gp_start_count fixed bin (18). 

2 gp_done_count fixed bin (18). 

2 nto_check_t irae fixed bin (71), 

2 nto_delta fixed bin (35), 

2 nto_count fixed bin (18), 

2 tcpii_schedul Ing fixed bin (18), 

2 nto_event bit (36). 

2 page_not if les fixed bin (18), 

2 not ify_nobody_count fixed bin (18), 

2 not ify_nobody_event bit (36), 

2 system_type fixed bin, 

2 Stat (0:15) fixed bin (18), 

/* 200 octal ♦/ 

2 wa i t ( a ) , 

3 time fixed bin (18), 
3 count fixed bin (18)l, 

2 ready (8), 

3 time fixed bin ( 18), 
3 count fixed bin (18), 

2 tota1_pf_time fixed bin (71). 

2 total _pf_count fixed bin (18), 

2 auto_tune_ws fixed bin (18), 

2 ocore_delta fixed bin (18), 

2 ws_sum fixed bin (18), 

2 nonldle_force_count fixed bin (18), 

2 itt_i ist_)ock bit (36)1 aligned, 

2 cpu_pf_t1ine fixed bin (71), 

2 cpu_pf_count fixed bin (18), 

2 specia)_of f sets unaligned. 



/♦ obsolete */ 

/• factor for scheduler quit response 

/« time to poll iobra ♦/ 

/♦ very large time ♦/ 

/• O => Just do get_ldle_processor ♦/ 



/♦ o => Just do get_id1e_processor ♦/ 
/♦ 

/» 
/♦ 



O => no intv q In percent mode ♦/ 

if fewer free buffs then stingy alloc strategy */ 

set this to >= half n_tty Hnes/fnp for safety */ 



/♦ hlstograni of run depths */ 

/* histogram of times run per depth */ 

/♦ histogram of page faults per depth ♦/ 

/♦ times ptl_wa1t noticed ptl was unlocked */ 

/♦ times window noticed */ 

/♦ O" locked, else unlocked */ 

/♦ num calls to ptl_wait ♦/ 

/* to detect gw_gp window lossage */ 

/* next time at which nto code will be called */ 

/♦ mlcrosec between nto checks ♦/ 

/* number of times nto detected ♦/ 

/♦ obsolete ♦/ 

/* last event which NTO'd */ 



/* used to be tcm. inter */ 

/♦ nuro apte's in each state ♦/ 

/♦ histogram of page fault waiting times versus did ♦/ 
/♦ histogram of times In ready queue */ 



/* total time spent from start to end of 

all page faults */ 

/* total number of page faults metered */ 

/* 0''> dont , atherwise compensate for quantum I en */ 

/» number of pages reserved for int users ♦/ 

/♦ totail of ellglble's ws_slzes t/ 

/* count of eligibilities forced */ 

/♦ Lock on ITT free list ♦/ 

/♦ total cpu time spent handling page faults ♦/ 

/♦ total count of cpu time meterings ♦/ 
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3 apt_offset bit ( IS). 

3 pad bit ( 18), 
a getwork_tln)e ftxed btn (71), 
2 aetwork_count fixed bin (18). 
2 short_pf_count fixed bin (18). 
2 1nterrupT_t1me fixed bin (71), 
2 1nterrupt_count fixed bin (71 ), 
:e ocore fixed bin (35, 18), 
2 pre_empt flag bit (36) aligned, 
2 cumulat1ve_meniory_U8age fixed binary (71). 
2 processor_tlme_at_def 1ne_wc fixed bin (71), 
2 boos t_pr lor Ity fixed bin. 
2 lost priority fixed bin. 
2 totaT_clock_lag fixed bin (71), 
2 clock_slmu1at1ons fixed bin, 
a max_clock_lag fixed bin, 

/« 3()0 octal «/ 

2 pdscopyl fixed bin (18). 

a max_hproc_8egno fixed bin. 

a prds_length fixed bin (18), 

a pds_length fixed bin (18), 

a lock fixed bin (18), 

a Id fixed bin (18), 

a systein_shutdown fixed bin (18), 

a work 1ng_8et_f actor fixed bin (35, 18), 

a ncpu fixed bin (18), 

a last.ellglbla bit (18). 

a apt_lock fixed bin (35), 

2 apt_slze fixed bin (18). 

a reaTt1me_q aligned like ba8ed_sent Inel . 

a aht_size fixed bin (18). 

a ltt_slze fixed bin (18). 

a dst_s1ze fixed bin (18), 

2 Itt free_1 1st bit (18). 

2 UBed_ltt fixed bin (18). 

2 Initial lzer_ld bit (36) aligned, 

2 n_e11gtb1e fixed bin (18). 

2 max_e1lg1ble fixed bin (30), 

a wa1t_enable fixed bin (18), 

2 apt_entry_sl2e fixed bin (18). 

2 lnteractlve_q aligned like based_sent Inel , 

2 dat_ptr ptr. 

2 old_user ptr, 

a Initial Ize_t1me fixed bin (71), 

a 1n1t_event fixed bin (18), 
;2 oldt fixed bin (18), 
2 newt fixed bin ( 18), 
2 teflrst fixed bin (30), 
2 telast fixed bin (30). 



/♦ total time spent In getwork ♦/ 

/♦ total times through getwork */ 

/♦ number of short page faults */ 

/♦ total time spent In Interrupt ♦/ 

/* total number of metered Interrupts */ 

/♦ fraction of core for Int've users */ 

/* controls whether preempting at done time */ 

/* total number of memory usage units */ 

/• value of processor_t1roe when WC's last defined */ 

/* number of times priority process given high priority */ 

/♦ number of times priority process lost eligibility ♦/ 

/♦ sum of all simulated clock delays ♦/ 

/♦ number of times alarm clock Interrupt was simulated */ 

/* largest simulated alarm clock delay */ 



/* amount of pda to copy for new process */ 

/• largest allowed hardcore segment number ♦/ 

/♦ length of PROS */ 

/♦ length of PDS */ 

/♦ process Id generator lock ♦/ 

/♦ next process Id to be given out ♦/ 

/♦ working set factor */ 

/♦ number of processors currently being used */ 

/* last process to gain eligibility ♦/ 

/♦ + write; O hidden: -1 unlocked; -(N+1) Nreaders */ 

/* number of APT entries »/ 

/* processes with realtime deadlines */ 

/* APT hash table size */ 

/* number of ITT entries */ 

/♦ number of allowed DST entries ♦/ 

/• pointer to ITT free list */ 

/♦ number of used ITT entries */ 

/♦ process Id of Initializer */ 

/♦ number of processes eligible ♦/ 

/* maximum allowed number of eligible processes */ 

/* turned on when waiting mechanism works */ 

/* size of an APT entry */ 

/♦ head of interactive queue */ 
/♦ pointer to device signal table */ 
/♦ last process to run (apt ptr ) */ 
/♦ time of Initialization */ 

/* wait event during Initialization •/ 
/♦ timer reading from previous process */ 
/♦ timer setting for new process */ 
/* first eligible time */ 
/* last eligible time »/ 
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2 tlmax fixed bin (35), 

2 empty_q bit (18). 

2 worklng_set_addend fixed bin (18), 

2 ready_q_head bit (O) aligned, 

2 e) 1gible_q_head aligned like based_Bent Inel , 

2 ready_q_tall bit (O) aligned, 

2 el ig1ble_q_tall aligned like baaed_sent Inel . 

2 1dle_taU aligned like based_sent inel , 

2 in1n_el Igtble fixed bin (30), 

2 alarm_t1mer_l 1st bit (18) aligned, 

2 giiaranteed_el 1g_1nc fixed bin (35). 

2 prior It y_sched_1nc fixed bin (35), 

2 next_alarm_t ime fixed bin (71), 

2 priori ty_sched_t ime fixed bin (71). 

2 tty_pon ing_t Ime fixed bin (71). 

2 disk_pol I 1ng_t Ime fixed bin (71). 

2 tapepol I ing_tliiie fixed bin (71), 

2 lmp_pol I lng_tlnie fixed bin (71). 

2 iinp_pon 1ng_lock fixed bin (18). 

2 max cliannels fixed bin (18), 



I* time In queue for lowest level */ 

/♦ thread of empty APT entries ♦/ 

/♦ additive working set parameter */ 

/♦ for added segdef ♦/ 

/» head of el igible queue */ 

/* for added segdef ♦/ 

/* tall of eligible queue */ 

/* tall of idle list ♦/ 

/♦ rel pointer to apt entry for next alarm timer */ 

/* amount of guaranteed eligibility time in mlcrosecs. ♦/ 

/* amount of block time before process is given priority */ 

/* clock time for next alarm timer ♦/ 

/♦ time for priority process to be given priority */ 

/♦ time to poll TTY DIM ♦/ 

/* time to poll disk DIM */ 

/* time to poll tape DIM */ 

/♦ time to pol I imp ♦/ 

/» do not poll if lock set ♦/ 

/♦ num special channels per process ♦/ 



/* 400 octal */ 

2 systera_virtual_t1roe fixed bin (71). 

2 cred1t_bank fixed bin (71). 

2 ra1n_wct_index bit (18) aligned, 

2 roax_wct_1ndex bit (18) aligned, 

2 delta_vt fixed bin (71), 

2 gross_idle_t Ima fixed bin (71), 

2 credi ts_per_scatter fixed bin (35), 

2 best_credit_value fixed bin (18). 

2 def 1ne_wc_tTme fixed bin (71), 

2 max_batch_el Ig fixed bin (35), 

2 num_batch_el Ig fixed bin (35), 

2 deadl 1ne_mode fixed bin (35), 

2 credi ts_scattered fixed bin (35). 

2 max_max_e1 Igible fixed bin (30), 

2 max_stopped_stack_0 fixed bin (35), 

2 stopped_stack_0 fixed bin (35), 

2 mos_po1 I 1ng_interval fixed bin (35), 

2 mos_pol I ingt ime fixed bin (71), 

2 vcpu_response bounds ( VCPU_RESPONSE._BOUNDS) 

2 vcpu_response_bounds_s1ze fixed bin (35), 

2 meter_response_t irae_cal 1 s fixed bin (35), 

2 meter_response_t lme_invaHd fixed bin (35). 

2 meter_response_t lme_overhead fixed lain (71), 

2 1n1t_wa1 t_t ime fixed bin (71). 

2 lnlt_wal t_t1meout fixed bin (71), 

2 ini t_t lmeout_sever 1 ty fixed bin, 

2 inl t_t tmeout_recurse fixed bin, 

2 max_t imer__register fixed bin (71), 

2 pre_em,ot_sample_t ime fixed bin (35), 

2 govern ing_cred1t_bank fixed bin (35), 

2 process_1n1t 1al_quantum fixed bin (35), 

2 def aul t_procs_required bit (8) aligned. 



/* non-idle virtual time ♦/ 

/♦ credits not yet passed out ♦/ 

/♦ offset of Initializer work class table entry 

/* offset of highest wcte currently defined ♦/ 

/♦ temp used by pxss.compute_vlrtual_clocks ♦/ 

/♦ Idle t ime_used_clock ♦/ 

/♦ total number of credits awarded at once ♦/ 

/♦ temp for pxss. f 1nd_next_el igible */ 

/♦ clock time when workclasses last degined ♦/ 



/* 0=> ti sorts, else deadline sorts ♦/ 

/* Maximum of maxe ♦/ 

/♦ Maximum stack_0's suspended by stopped procs ♦/ 
/♦ Number stack_0's suspended by stopped procs ♦/ 
/* for heals */ 
/♦ for heals */ 
fixed bin (35) . 



/* used by wait/notify during Initialization ♦/ 

/• not If y- timeout Interval during initialization ♦/ 

/♦ not if y- timeout severity during initialization ♦/ 

/» count of NTO recursion during initialization ♦/ 

/* max cpu burst = # cpus x pre_empt_sarople_t ime ♦/ 

/♦ tuning parameter - max time between samples */ 

/♦ used for limiting eligibility on governed work classes*/ 

/♦ eligibility quantum first eligibility ♦/ 

/♦ default mask of CPUs required */ 
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2 work_class_tdle fixed bin (71). 

/♦ Tuning Parameters for Stack Truncation */ 

2 Btk_truncate bit (1) aligned. 
2 stk~truncate_always bit (1) aligned. 
2 stk_trunc_avg_f 1 fixed bin (35. 18), 
2 Btk_trunc_avg~f2 fixed bin (35. 18), 
2 lock_error_sever1ty fixed bin, 

2 gv_1ntegratlon fixed bin (35), 

2 Bv_1ntegratlon_set bit (1) aligned, 

2 pads fixed bin (3S). 

2 vo1map_poM 1ng_t1ine fixed bin (71), 

2 pad9 fixed bin (71), 

2 rea1tlnie_lo_pr1orlty_8wltch fixed bin, 

2 realt1me_lo_dead11ne fixed bin (35), 

2 realt1me_1o_quantuiii fixed bin (35). 

2 real t1nie_pr1orlt1as fixed bin (35), 

2 relinquishes fixed bin (35). 

2 abort_lp8_ma8k bit (36) aligned. 

/* 500 octal »/ 

2 pads (192) fixed bin (35). 
/* 1000 octal */ 

2 pad7 (64) fixed bin (35), 

/• 1100 octal ♦/ 

2 pad6 (8) fixed bin (35), 
2 work_c1ass_table aligned. 

3 wcte (0:16) aligned like wct_entry, 

/* 3000 octal */ 

2 apt fixed bin; 

del wctep ptr; 

del 1 wct_entry aligned based (wctep). 
2 thread unaligned, 

3 fp bit ( 18). 

3 bp bit (18), 
2 flags unal Igned, 

3 uinbz bit (1). 

3 defined bit (1). 

3 lo_pr1or1ty bit (1). 

3 governed bit (1). 

3 Interact lve_q bit ((), 

3 pad bit (31), 



/♦ Idle time due to work class restrictions */ 



/♦ syserr severity */ 

/* Integration Interval for governing ♦/ 
/♦ ON '> gv_1ntegrat Ion set by ctp ♦/ 



/♦ o -> give I/O Interrupt wakeups realtime prlotlry •/ 

/♦ Delta to clock for I/O realtime deadline */ 

/* Quantum for I/O realtime burst ♦/ 

/* Count for metering ♦/ 

/* Calls to rel 1nqulsh_prlorlty */ 

/• IPS mask for tc ut lT$check_abort ♦/ 



/* room for expansion compatibly 



•/ 



/* array of per workclass Information */ 



credits fixed bin (35), 
minf fixed bin (35). 



/♦ Work class entry */ 
/♦ Ready 1 1st */ 
/♦ Head of ready list */ 
/• Tall of ready I Ist */ 

/* Sentinel bit must not be zero. 



/♦ Current worthiness of group */ 
/* min fraction of cpu */ 
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2 p1n_weight f I XQd bin (35), 

2 ellgtbnitles fixed bin (35), 

2 cpu_sura fixed bin (71), 

2 lespl fixed bin (71), 

2 resp2 f ixed bin (7t ), 

2 qtiantumi fixed bin (35), 

2 quantum2 fixed bin (35), 

2 rnieterl fixed bin (71), 

2 rnieter2 fixed bin (71), 

2 rcountt fixed bin (35). 

2 rcount2 fixed bin (35). 

2 realtime fixed bin (35), 

2 purging fixed bin (35), 

2 maxel fixed bin (35), 

2 nel fixed bin (35), 

2 nuinber_t1)inl<s fixed bin (35), 

2 number_queues fixed bin (35), 

2 total_thinlt_tlme fixed bin (71), 

2 total_queue_tlme fixed bin (71), 



/« number of cycles to pin pages */ 
/• Count of eligibilities awarded */ 
/* CPU used by members ♦/ 



/♦number times process entered "thlnt<" state */ 
/* number times process entered "queued" state »/ 



/♦ The next three arrays correspond to the array vcpu_responae_bounds 

2 number_processing ( VCPU_R£SP0NSE_B0UNDS+1 ) fixed bin (35), /* number tiroes entered 

2 total_processlng_time (VCPU_RESP0NSE_B0UN0S+1 ) fixed bin (71). 

2 total_vcpu_time { VCPU_RESPONSE_BOUNDS+ 1 ) fixed bin (71), 

2 maxf fixed bin (35). /* 

2 govern lng_cr edits fixed bin (35). /♦ 

2 padi (4) fixed bin (35): 



"processing" state 



maximum fraction of cpu time 
for limiting cpu resources 



*/ 
♦/ 



•/ 
*/ 



del 1 based_sent inel aligned based, 
2 fp bit ( la) unal , 
2 bp bit ( la) unal , 
2 sentinel bit (36) aligned; 



/♦ format of pxss-style sentlnai ♦/ 



del VCPU_RESPONSE_BOUNDS fixed bin Init (3) Int static options (constant); 
/♦ END INCLUDE FILE tcm.lncl.pl1 */ 



Include.**, hard. source 
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vo1_map. Incl .pi 1 



segment tn: 
entry rood! f ted: 



>ldd> Include 
03/10/82 0836.5 



contents modified: 02/24/76 2027.5 



/* BEGIN INCLUDE FILE ... vol_map. Inol .pi 1 */ 

del vol_iiiapp ptr; 

del I voljmap based (vol_niapp) aligned, 

a n_rec fixed bln(t7), 

2 base_add fixed b1n(17), 

2 n_free_rec fixed bin(17), 

2 b 1 t_«iiap_n_words f 1 xed b 1 n( 1 7 ) , 

2 pad (60) bit(36). 

2 blt_map (3*1024 - 64) blt(36) ; 

/* END INCLUDE . . . vol_map */ 



/• number of records represented in the map */ 

/* record number for first bit in bit map »/ 

/* number of free records */ 

/» number of words of the bit map ♦/ 

/* pad to 64 words */ 

/♦ bit map - the entire vol roap occupies 3 records */ 



inciuc" *. hard. source 
Feo«v lot to be reproduced 
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vtoc buf f er . Incl .pi 1 



segment In: 

entry modified: 



> I dd> t nc 1 ude 
11/19/82 1604.3 



contents modified: 11/19/82 1602.2 



/• START OF: vtoc_buf f er . (ncl .pll November . 1982 
del vtoc_buf fer_seg$ ext; 



del 


vtoc buffer_segp 


ptr; 


del 


vtoc buf descp 


ptr; 


del 


vtoc bufp 


ptr; 


del 


vtoc buf desc arrayp 


ptr; 


del 


vtoc_buf_arrayp 


ptr; 


del 


vtoc buf n buffers 


fixed bin: 


del 


vtoe buf n buckets 


fixed bin; 



del 



V 


toc_buf f ar 


aligned based (vtoc_ 


buffer 


2 


lock. 








/* 




3 process id 


bit (36) aligned. 


/* 




3 wait_event 


bit (36) al Igned. 


/♦ 




3 notlfy_sw 


bit ( 1) al igned. 


/* 


2 


n_buf s 


fixed 


bin 




/* 


2 


n_hash_buckets 


fixed 


bin 




/• 


2 


hash_mask 


bit (36) aligned. 


/* 


2 


abs_addr 


fixed 


bin 


(24). 


/♦ 


2 


wal t_evant_constant fixed bin (36) uns 


unal , 


2 


buf_desc_of f set 


bit (18). 




/* 


2 


buf_of fset 


bit (18), 




/♦ 


2 


hasii_table_of f set 


bit (18). 




/♦ 


2 


search_ Index 


fixed 


bin 




/* 


2 


unsaf e_pvtx 


fixed 


bin 




/♦ 


2 


scavenger_f ree_p_c 


lock 












fixed 


bin 


(35), 


/* 


2 


meters, 












3 eal l_get 


fixed 


bin 


(35), 


/• 




3 eal l_put 


fixed 


bin 


(35). 


/• 




3 eal l_al loc 


fixed 


bin 


(35). 


/♦ 




3 eal Ifree 


fixed 


bin 


(35). 


/♦ 




3 eal I_awal t 


fixed 


bin 


(35). 


/♦ 




3 steps 


fixed 


bin 


(35). 


/♦ 




3 skip OS 


fixed 


bin 


(35). 


/♦ 




3 akip_hot 


fixed 


bin 


(35). 


/* 




3 sklp_walt 


fixed 


bin 


(35). 


/» 




3 disk_reads 


fixed 


bin 


(35). 


/* 




3 disk_writes 


fixed 


bin 


(35), 


/♦ 




3 get_buf f er_cal Is 


fixed 


bin 


(35), 


/♦ 




3 get_buf fer_hlts 


fixed 


bin 


(35). 


/* 




3 wait_calls 


fixed 


bin 


(35). 


/♦ 




3 wait_os 


fixed 


bin 


(35). 


/* 



,segp ) , 



Hock 



for VTOC buffers »/ 



G I oba I 

Owner 

for lock ♦/ 

ON «> notify on unlock 



♦/ 



Number of full" VTOCE buffers ♦/ 
Number of hash table buckets */ 
Mask for hash algorithm ♦/ 
Absolute address of vtoc_buf f er_seg */ 

/* Constant to add to part index to form wait event */ 
Offset of buf_deBc */ 
Offset of buf */ 
Offset of hash_table */ 
Roving pointer for buffer selection ♦/ 
PVTE Index with update in progress »/ 

Pseudo-Clock for scavenger-f ree-other-al locate race */ 

Calls to get_vtoce ♦/ 

Calls to put_vtoce */ 

Calls to al loc_and_put_vtoce */ 

Calls to free_vtoce ♦/ 

Calls to await_vtoce »/ 

Steps through buffer allocation •/ . 

S)<lpped because out-of -service '•'/ 

Skipped because buffer hot ♦/ 

Skipped because notify_sw set ♦/ 

Number of same ♦/ 

Number of same */ 

Number of calls to GET_BUFFER */ 

Number times VTOCE In buffer ♦/ 

Number of calls to WAIT ''/ 

Number of times had to wait */ 



include.**, hard. source 
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e */ 



3 scavenger_f ree_checks 

fixed bin (35) 
3 8cavenger_f ree_lo88es 

fixed b«n (35) 



3 pad ( 15) 
2 hash table 



/* Number of times had to check pseudo-clock */ 

/* Number of times race lost between scavenger freeing and other allocat 

fixed bin (35). 

(vtoc buf_n buckets refer (vtoc_buf fer .n_hash_bucket6) ) bit (18) aligned. 



2 buf_desc 
2 buffer 



(vtoc_buf_n_buffer8 refer (vtoc_buf f er .n_buf s) ) aligned like vtoc_buf_desc. 
(vtoc_buf_n_buffers refer (vtoc_buf f er ,n_buf s) ) aligned like vtoce_buf fer ; 



del 1 vtoc_buf_desc_array (vtoc_buf fer .n_buf s) aligned based (vtoc_buf_desc_arrayp) 1 Ike vtoc_buf_desc; 



del 



del 
del 



vtoc_buf_deso 
2 pvtx 

vtocx 

parts_U8ed 

err 

not 1 f y_8W 

wrlte_sw 

OS 



loq 
used 
pad 
wait 



Index 



ht_thread 
buf ret 



1 vtoee_buf fer_arrBy 

1 vtoce_buffer 
2 parts 
3 words 



aligned based (vtoc_buf. 
fixed bin ( 17) unal . 
fixed bin ( 17) unal , 
bit (3) unal. 

unal . 

unal , 

unal , 

unal . 

unal . 

unal , 

unal , 



(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

(9) 

fixed bin (17) 
bit (18) unal . 
bit (18) una I ; 



bit 
bit 
bit 
bit 
bit 
bit 
bit 



unal 



descp), 

"/♦ PVTE Index •/ 
/* VTOCE Index ♦/ 
/* Mask of parts used or os */ 
/♦ ON «> I/O error on buffer ♦/ 
/* ON •> notify requled on I/O completion ♦/ 
/♦ ON •> write I/O ♦./ 
/♦ ON ■> I/O In progress */ 
/* ON "> I/O has been requested ♦/ 
/* ON «> this descriptor Is In use ♦/ 

/♦ Buffer Index for forming wait event */ 
/♦ Offset of next entry In hash table */ 
/♦ Offset of buffer In segment */ * 



(vtoc_buffer.n_bufs) aligned based (vtoc_buf_arrayp) like vtoce_buf fer j 



aligned based (vtoc_tiufp) . 

(3) a I Igned. 

(64) bit (36) aligned; 



del N_PARTS PER_VTOCE 

del VTOCE_PART_SIZE 

del VTOCE_BUFFER_SIZE 

del N_VTOCE_PER_RECORD 

del N SECTOR PER VTOCE 



fixed bin Int static options (constant) Inlt (3)j 

fixed bin Int static options (constant) Inlt (64); 

fixed bin Int static options (constant) Inlt (3 * 64): 

fixed bin Int static options (constant) Inlt (5); 

fixed bin Int static options (constant) Inlt (3): 



END OF: 



vtoc buf fer. Incl .pi 1 



*/ 



Includf ♦, hard. source 
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vtoc_header . Incl .pi 1 



segment In: 

entry modt f led: 



> I dd> i nc ) ude 
03/10/82 0836.5 



contents modified: 05/05/77 0832.2 



/• BEGIN INCLUDE FILE ... vtoc_header . incl .pi 1 ♦/ 

del vtoc_headerp ptr; 

del 1 vtoc_header based ( vtoc_headerp) aligned, 

2 version fixed bin (17), 

2 n_vtoce fixed bin (17), 

2 vtoc_last_recno fixed bin (17). 

2 n_free_vtoce fixed bin (17), 

2 f lrst_free_vtocx fixed bin (17). 

2 pad (3) bit (36), 

2 dmpr_blt_map (2048 - 8) bit (36).; 



/* version number. The current version number Is 1. 

/♦ number of vtoc entries ♦/ 

/» record number of ttie last record of tiie vtoc */ 

/* number of free vtoc entries */ 

/♦ Index of tlie first vtoce in the free list */ 

/♦ space for dmpr bit map ♦/ 



♦/ 



/* END INCLUDE 



vtoc_header */ 



include. ♦♦, hard. source 
F80A - Not to be reproduced 
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vtoc_map. IncI .pi 1 



segment <n: >ldd> Include 

entry inodlfted: 05/20/82 1047.7 



contents modified: 05/2O/82 103B.4 



/♦ START OF: 

del 
del 



vtoc_niap. Incl .pll ... March 1982 



♦/ 



vtoc_mapp 

b 1 t_niap_wordp 



del 1 vtoo_niap 

2 n_vtoce 
2 n_free_vtoce 
2 b1t_map_n_words 
2 vtoc_last_recno 
2 pad 
2 b1t_map 

del 1 bit niap_word 

2 padi 
2 bits 
2 pad3 



ptrj 
ptrj 

aligned based (vtoc_niapp) 

f Ixed bin, 

fixed bin, 

f 1 xed bin, 

f txed bin, 

(4) fixed bin. 

(O: 1024 - 9) bit (36); 



/♦ Number of VTOCEs on the device */ 

/♦ Number of free VTOCEs */ 

/* Number of words In the bit map below */ 

/♦ Last record number in VTOC ♦/ 

/• This structure consumes exactly 1 page ♦/ 



aligned based ( b 1 t_map_wordp ) , 

bit (1) unal. 

bit (32) unal, /♦ 32 VTOCES ON ■> free ♦/ 

bit (3) una): 



/• END OF: 



vtoc_map. Incl .pi 1 



*/ 



includ *, hard. source 
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vtoce. tnci .pi t 



segment tn: 

entry modi f ted: 



>ldd> Include 
1tl/16/82 1456,6 



contents modified: 41/16/82 1454.7 



/♦ BEGIN INCLUDE FILE .. .vtoce. Incl .pi 1 ... last modified September 1982 »/ 

/♦ Template for a VTOC entry. Length » 192 words. (3 ♦64). ♦/ 

del vtocep ptr; 

del 1 vtoce based (vtocep) aligned. 



(2 pad_f ree_vtoce_chain bit (36), 

2uidb1t(36), 

2 msl bit (9). 
2 csl bit (9). 
2 records bit (9), 
2 pad2 bit (9), 

2 dtu bit (36). 

2 dtm bit (36), 

2 nqsw bit (1), 

2 deciduous bit (1), 

2 nid bit (1), 

2 dnzp bit (1), 

2 gtpd bit (1). 

2 per_process bit (1), 

2 daTnaged bit ( 1) . 

2 fm_damaged bit (1). 

2 fm_checksum_val id bit (1), 

2 synchronized bit (1), 

2 pad3 bit (8). 

2 dirsw bit (1). 

2 roaster_d1r bit ( 1 ). 

2 pad4 bit (16)) unaligned. 

2 fm_checksum bit (36) aligned, 

(2 quota (0:1) fixed bin (18) unsigned, 

2 used (0:1) fixed bin (18) unsigned. 

2 received (0:1) fixed bin (18) unsigned, 

2 trp (O: 1) fixed bin (71). 

2 trp_t Ime (O: 1) bit (36). 



/♦ Used to be pointer to next free VTOCE •/ 

/♦ segment's uld - zero if vtoce is free */ 

/* maximum segment length In 1024 word units ♦/ 

/♦ current segment length - in 1024 word units ♦/ 

/* number of records used by the seg in second storage */ 

/* date and time segment was last used */ 

/* date and time segment was last modified */ 

/* no quota switch - no checking for pages of this seg */ 

/* true if hc_sdw */ 

/♦ no Incremental dump switch */ 

/* Oont null zero pages ♦/ 

/* Global transparent paging device */ 

/* Per process segment (deleted every bootload) */ 

/* TRUE If contents damaged */ 

/* TRUE If fllemap checksum bad ♦/ 

I* TRUE if the checksum has been computed */ 

/* TRUE 'if this Is a data management synchronized segment */ 

/♦ directory switch */ 

/♦ master directory - a root for the logical volume */ 

/* not used */ 

/* Checksum of used portion of file map */ 

/* sec storage quota - (0) for non dlr pages •/ 

/* sec storage used - (0) for non dlr pages ♦/ 

/* total amount of storage this dlr has received */ 

/* time record product - (O) for non dlr pages ♦/ 

/* time t lme_record_product was last calculated »/ 



Include.**, hard. source 
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2 fm (0:255) bit (18). 

2 pad6 (10) bit (36). 

2 ncd bit (1). 
2 pad? bit (17). 
2 pads bit (18). 

2 dtd bit (36). 

2 voltd (3) bit (36), 

2 master dir uld bit (36), 



/♦ file map - 256 entries - 18 bits per entry */ 

/* not used */ 

/* no complete dump switch */ 

/♦ date- time-dumped ♦/ 

/* volume Ids of last Incremental, consolidated, and complete dumps */ 

/* superior master directory uld */ 



2 u1d_path (0:15) bit (36). 

2 prlmary_name char (32). 

2 t1me_created bit (36). 

2 par_pv1d bit (36), 

2 par_vtocx fixed bin (17). 

2 branch_rp bit (18)) unaligned. 

2 cn_salv_t1me bit (36). 

2 acces3_c1asB bit (72), 
2 perm_flags aligned. 

3 per_bootload bit (1) unal , 

3 pad9 bit (35) unal , 
2 owner bit (36); 



del vtoce_parts (3) bit (36 ♦ 64) aligned based (vtocep); 

del 1 seg_vtoce based (vtocep) aligned, 
2 padi bit (7*36), 
2 usage fixed bin (35). 
2 pad2 bit ( 184*36); 



/* uld pathname of all parents starting after the root */ 

/* primary name of the segment */ 

/* time the segment was created ♦/ 

/* physical volume Id of the parent */ 

/♦ vtbc entry index of the parent */ 

/* rel pointer of the branch of this segment */ 

/♦ time branch - vtoce connection checked */ 

/* access class in branch */ 

/* ON "> deleted each boot load */ 

/• pvid of this volume */ 

/♦ Overlay for vtoce of segments, which don't have quota */ 
/* page fault count: overlays quota ♦/ 



/* 



END INCLUDE FILE vtoce. Incl .pi 1 */ 



includr ♦, hard. source 
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SNAPSHOT 09/17/86 08:59 



Hultics MRlO.Zy load 45.C/6Q.0; 47 users/ 24 interactive/ 22 daemons. 

Absentee users 1/4 

avq = 11/ elapsed time ~ 930 sec/ 30 active last 15 sec. 

Virtual CPU Time 29.02 41.46 

Zero Idle 0.00 

NMP Idle 30.02 

1 1487 4.87 0-00 0.50 2263 C.Oj 0.14 70.09 vADIS 

All 1994 8.76 0,00 0.50 2828 0-01 0.39 27.70 

4. 0.35 3 0.26 2.10 0.26 2.1C P R I Init 

1 16. 0.09 1 1.00 0.50 1.GC 1.UC.P R I VADIS 

2 10. 0. 0.95 1 'p I System Sy 

5 21, 26. 0.80 1 P I Other 

4 11. 0.02 1 0.13 1.00 0.50 1.00 P R I 10 
xLtlD(b) 460 0.008 0-1 Idle 
rLEKaJ 341 0.000 0-1 Idle 
wL£ 156 13765 1000 8 0.020 34465 4 Retriev 
b 117 11693 2000 5267 6000 48.105 3 Alonso 
wWLE 114 13513 2000 118 2003 6000 0.084 273211 3 Cintro 
wL£ 70 4502 100G 3 6000 0.189 -400000000000 1 
b 70 817 2000 49 162.744 3 Figuero 
b 47 1356 2097 ' 78 2.271 /) Ri os 

b 39 2223 1000 87 0.161 'O 1 IslaGra 

b 34 2158 1000 C 161 1.442 1 Caguas 

Paye Faults 11,74 16.78 2717.319 
Laps 124 7.479 sec. 

allocations ^Jitr u u.uu u.uuu 

allocations 68230 9515 13.95 11.462 

9 261 10500 47 3553 88 86 

1 7005 30S1 167 132 300 
7 5000 5091 128 185 182 

15 4736 4294 158 195 215 

15 5296 3526 202 175 263 

6 4787 3641 131 193 254 

5 4099 3881 161 226 238 

2 6264 592 200 148 1566 



10 2714 182 307 341 5095 
14 2619 209 291 354 4437 

5 617 327 73 150 2 2835 

11 255 158 150 3636 5869 

12 27 19 34346 
Sej Faults 5.11 7.30 18332.578 

Lap Time(sec) 191.9 706.6 1973.2 84.0 

Otner fault 10.29 14.71 

Getwork 4,53 6.48 498.232 

HP Idle 5,92 3.46 
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dpsS 70. 


8. 






cpu 


b 6 


on 


dps8 70. 


8. 






chnl 


dska 


a 


34 


2 








chnl 


dskb 


a 


30 


4 








sst 


600. 


400 


. 300. 750. 






salv 


dcf 














prph 


dska 


a 


20 


4 451. 


20 






prph 


dskb 


a 


24 


4 451. 


20 






prph 


tapa 
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10 


1600, 
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136. 
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prtb 
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11 
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136. 
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a 
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warm 
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iom 
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mem 


d 512 


! . < 


on 










mem 
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on 










mem 


b 512 


!. < 
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mem 


a 2048. 


on 
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36 













Drive 



dska_05 

dska_ll 

dska_12 

dskb_09 

dskb_05 

dskb_06 

dskb_07 

dska_01 

dskb_02 

dskb_or 

dska_15 

dskb_15 

dska_04 

dska_06 

dska_10 

dska_13 

dskb_08 

dskb_14 

dskb 16 



Records 



Left % VTOCEs Left % 



Avg PV 
Size Name 



PB/PD LV Name 



36584 1354 4 7625 4605 60 11 cis2 pb 

36584 2455 7 7625 4814 63 12 cisl pb 

36584 6226 17 7625 . 4154 54 8 Iddl pb 

36720 27412 75 7650 7592 99 160 progra pb 

36720 2521 7 7650 1986 26 6 publicOl pb pd 

36720 1954 5 7650 1717 22 5 public03 pb pd 

36720 2373 6 7650 1791 23 5 public02 pb pd 

29811 1121 4 17400 12774 73 6 rpv pb 

35837 1968 5 7575 2971 39 7 root2 pb 

36584 2805 8 7625 2987 39 7 root3 pb 

36584 3604 10 7625 5209 68 13 vadis_mifecl pb pd 

36584 5178 14 7625 5478 72 14 vadis_misc2 pb pd 

37967 182 710 562 79 255 vadis_pf7 pb 

37967 168 710 560 79 251 vadis_pf5 pb 

37967 433 1 710 563 79 255 vadis_pf3 pb 

37967 398 1 710 561 79 252 vadis_pf2 pb 

38094 299 1 710 561 79 253 vadis_pfl pb 

37967 60 710 561 79 254 vadis_pf6 pb 

37967 310 1 710 5€1 79 252 vadis_pf4 pb 
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Idd 

progra 

public 
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public 

root 

root 

root 

vadis_mis 

vadis_mis 

vadis_pf 
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vadis_pf 
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vadis_pf 

vadis_pf 



Current system tuning parameters: 
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cimax 

priority_sched_inc 
min_eligible 
max_eligible 
max_batch_el ig 
working_set_f actor 
working_set_addend 
deadl ine_mode 
i nt_q;_enab 1 ed 
post_purge 
pre_empt_sample_time 

-gp_at_notify-'-"'" '■■•'■■■•■■•■■■ -•-- 

gp_at_ptlnot i f y 

process_initial_quantum 

quit_priority 

notify_timeout_interval 

notify_timeout_severity 

write_limit 

gv_integration 

realtime_io_priority 

realtime_io_deadline 

realtime_io_guantum 



1 . seconds 
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80. seconds 
2. 

8. 



0.5 



Off 

on 

off 

0.04 seconds 

off 

off 
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0. 
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100 
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. seconds 

0.005 seconds 
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Figure 6-1. Page Control Data Bases 
fage not in nain memory or on paging device 
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COMMON MULTICS PERFORMANCE PROBLEMS 
Sj^eia Tasks Taki jTg_InQ__Much_ Re sourc es 

MTAR 

Too much backup during prime time 

Directory salvaging after ESDless crash 

System personnel favored by workclass parameters 

.Parameters S^'t ^rv^^ 

Work Class Parameters 

Absentees in separate workclass f^rvr i/jJ T,v~«> 

Traffic Control Parameters "^ t-' - r^t — -roo Y.^ty K 

telast too high 

maxe wrong, usually too low 

AST Size 

Segment thrashing due to small pool size(s) 

Hardwa re Conf iguration 

Not enough memory 
Not enough disk channels 
Not enough logical channels 
Not enough disk arms 
Insufficient CPU power 

n-i eV T /r\ 

Unbalanced disk I/O 

C ommun i cations,, 

HASP lines ^ _ J , _ 

X.25 lines C/l"^^ ^olorf^pfS^ ^ol r^t^cA •/ou Cft^^ (^o C<«6g-' 

breakall on dialout lines 

jjisc 

Bootload console looping 
Initializer time at maxu users 

Application causing segment thrashing 

Application using too much CPU time 

Bad write/notify cables -^ wr^^r /■ o i i 

^ T rv&Kc>s CYxj clear Ccvot.^^ r/w^!v«-/ 



.'/. 



